Array.prototype[@@unscopables]
A propriedade de símbolo @@unscopable contém nomes de propriedades que não foram incluídos no padrão ECMAScript antes da versão ES2015. Essas propriedades são excluídas do statement bindings with.
Sintaxe
arr[Symbol.unscopables]
Descrição
As propriedades padrão de array que são excluídas dos bindings with são: copyWithin, entries, fill, find, findIndex, includes, keys, e values.
Veja Symbol.unscopables para saber como definir unscopables para seus objetos.
Property attributes of Array.prototype[@@unscopables] | |
|---|---|
| Writable | no |
| Enumerable | no |
| Configurable | yes |
Exemplos
O código a seguir funciona bem no ES5 e abaixo. No entanto, no ECMAScript 2015 e posterior, o método Array.prototype.keys() foi introduzido. Isso significa que dentro de ambientes with, as "keys" seriam agora o método e não a variável. É aqui que a propriedade de símbolo @@unscopables Array.prototype[@@unscopables] entra em ação e impede que alguns métodos do Array estejam sendo definidos na instrução with.
var keys = [];
with (Array.prototype) {
keys.push("alguma coisa");
}
Object.keys(Array.prototype[Symbol.unscopables]);
// ["copyWithin", "entries", "fill", "find", "findIndex",
// "includes", "keys", "values"]
Especificações
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype-%symbol.unscopables% |
Compatibilidade com navegadores
Loading…