Array.prototype[@@unscopables]

The @@unscopables data property contains property names that were not included in the ECMAScript standard prior to the ES2015 version and that are ignored for with statement-binding purposes.

Description

The default Array properties that are ignored for with statement-binding purposes are:

See Symbol.unscopables for how to set unscopables for your own objects.

Property attributes of Array.prototype[@@unscopables]
Writable no
Enumerable no
Configurable yes

Example

Imagine the keys.push('something') call below is in code that was written prior to ECMAScript 2015.

When ECMAScript 2015 introduced the Array.prototype.keys() method, if the @@unscopables data property had not also been introduced, that keys.push('something') call would break — because the JavaScript runtime would have interpreted keys as being the Array.prototype.keys() method, rather than the keys array defined in the example code.

So the @@unscopables data property for Array.prototype causes the Array properties introduced in ECMAScript 2015 to be ignored for with statement-binding purposes — allowing code that was written prior to ECMAScript 2015 to continue working as expected, rather than breaking.

var keys = [];

with (Array.prototype) {
  keys.push('something');
}

Object.keys(Array.prototype[Symbol.unscopables]);
// ["at", "copyWithin", "entries", "fill", "find", "findIndex",
//  "includes", "keys", "values"]

Specifications

Specification
ECMAScript Language Specification
# sec-array.prototype-@@unscopables

Browser compatibility

BCD tables only load in the browser

See also