The well-known symbol Symbol.species
specifies a function-valued property that the constructor function uses to create derived objects.
Property attributes of Symbol.species |
|
---|---|
Writable | no |
Enumerable | no |
Configurable | no |
Description
The species accessor property allows subclasses to override the default constructor for objects.
Examples
You might want to return Array
objects in your derived array class MyArray
. For example, when using methods such as map()
that return the default constructor, you want these methods to return a parent Array
object, instead of the MyArray
object. The species symbol lets you do this:
class MyArray extends Array { // Overwrite species to the parent Array constructor static get [Symbol.species]() { return Array; } } var a = new MyArray(1,2,3); var mapped = a.map(x => x * x); console.log(mapped instanceof MyArray); // false console.log(mapped instanceof Array); // true
Specifications
Specification | Status | Comment |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Symbol.species' in that specification. |
Standard | Initial definition. |
ECMAScript Latest Draft (ECMA-262) The definition of 'Symbol.species' in that specification. |
Living Standard |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 51 | 14 | 41 | No | 38 | 10 |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic support | Yes | Yes | 14 | 41 | No | 38 | 10 |
See also
Document Tags and Contributors
Tags:
Contributors to this page:
tylercrompton,
fscholz,
jameshkramer,
gsathya,
kdex,
mata007,
nilssolanki,
arai
Last updated by:
tylercrompton,