The ArrayBuffer[@@species]
static accessor property returns the constructor used to construct return values from array buffer methods.
Warning: The existence of @@species
allows execution of arbitrary code and may create security vulnerabilities. It also makes certain optimizations much harder. Engine implementers are investigating whether to remove this feature. Avoid relying on it if possible.
Syntax
ArrayBuffer[Symbol.species]
Return value
The value of the constructor (this
) on which get @@species
was called. The return value is used to construct return values from array buffer methods that create new array buffers.
Description
The @@species
accessor property returns the default constructor for ArrayBuffer
objects. Subclass constructors may override it to change the constructor assignment. The default implementation is basically:
class ArrayBuffer {
static get [Symbol.species]() {
return this;
}
}
Because of this polymorphic implementation, @@species
of derived subclasses would also return the constructor itself by default.
class SubArrayBuffer extends ArrayBuffer {}
SubArrayBuffer[Symbol.species] === SubArrayBuffer;
When calling array buffer methods that do not mutate the existing object but return a new array buffer instance (for example, slice()
), the object's constructor[@@species]
will be accessed. The returned constructor will be used to construct the return value of the array buffer method.
Species in ordinary objects
The @@species
property returns the default constructor function, which is the ArrayBuffer
constructor for ArrayBuffer
.
ArrayBuffer[Symbol.species];
Species in derived objects
In an instance of a custom ArrayBuffer
subclass, such as MyArrayBuffer
, the MyArrayBuffer
species is the MyArrayBuffer
constructor. However, you might want to overwrite this, in order to return parent ArrayBuffer
objects in your derived class methods:
class MyArrayBuffer extends ArrayBuffer {
static get [Symbol.species]() {
return ArrayBuffer;
}
}
Specifications
Browser compatibility
|
Desktop |
Mobile |
Server |
|
Chrome |
Edge |
Firefox |
Opera |
Safari |
Chrome Android |
Firefox for Android |
Opera Android |
Safari on IOS |
Samsung Internet |
WebView Android |
Deno |
Node.js |
@@species |
51 |
13 |
48 |
38 |
10 |
51 |
48 |
41 |
10 |
5.0 |
51 |
1.0 |
6.5.0 |