Array.prototype[Symbol.unscopables]

Свойство данных [Symbol.unscopables] объекта Array.prototype является общим для всех экземпляров Array. Оно содержит имена свойств, которые не были включены в стандарт ECMAScript до версии ES2015 и которые игнорируются для целей связывания оператора with.

Значение

Объект null-прототипа с именами свойств, указанными ниже, и их значениями, установленными в true.

Описание

Свойства Array по умолчанию, которые игнорируются для целей связывания оператора with:

• at()
• copyWithin()
• entries()
• fill()
• find()
• findIndex()
• findLast()
• findLastIndex()
• flat()
• flatMap()
• includes()
• keys()
• toReversed()
• toSorted()
• toSpliced()
• values()

Array.prototype[Symbol.unscopables] — это пустой объект, содержащий только все перечисленные выше имена свойств со значением true. Его прототипом является null, поэтому свойства Object.prototype, такие как toString, случайно не будут сделаны неучитываемыми (unscopable), и toString() внутри оператора with будет по-прежнему вызываться для массива.

Смотрите Symbol.unscopables, чтобы узнать, как установить неучитываемые свойства для ваших собственных объектов.

Примеры

Представьте, что вызов values.push('something') ниже находится в коде, написанном до ECMAScript 2015.

var values = [];

with (values) {
  values.push("something");
}

Когда ECMAScript 2015 представил метод Array.prototype.values(), оператор with в приведенном выше коде начал интерпретировать values как метод массива values.values вместо внешней переменной values. Вызов values.push('something') привел бы к сбою, потому что теперь он получает доступ к push в методе values.values. Это привело к сообщению об ошибке в Firefox (Ошибка Firefox 883914).

Таким образом, свойство данных [Symbol.unscopables] для Array.prototype приводит к тому, что свойства Array, введенные в ECMAScript 2015, игнорируются для целей связывания оператора with, что позволяет коду, написанному до ECMAScript 2015, продолжать работать должным образом, а не ломаться.

Спецификации

Совместимость с браузерами

Смотрите также

• Полифилл Array.prototype[Symbol.unscopables] в core-js
• Руководство по индексированным коллекциям
• Array
• with
• Symbol.unscopables