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 Language Specification # sec-array.prototype-%symbol.unscopables% |
Compatibilidade com navegadores
BCD tables only load in the browser