Array.prototype[@@unscopables]
La propriété symbol @@unscopable
contient les noms des propriétés qui ne faisait pas partie du standard ECMAScript avant ES2015 (ES6). Ces propriétés sont exclues lors de liaisons effectuée via l'instruction with
.
Syntaxe
arr[Symbol.unscopables];
Description
Les propriétés natives d'un objet Array
qui sont exclues lorsqu'on utilise with
sont copyWithin
, entries
, fill
, find
, findIndex
, includes
, keys
et values
.
Voir la page sur le symbole Symbol.unscopables
pour manipuler unscopables
sur des objets personnalisés.
Attributs de Array.prototype[@@unscopables] | |
---|---|
Écrivable | Non |
Énumérable | Non |
Configurable | Oui |
Exemples
Le code qui suit fonctionne bien pour ES5 et les versions antérieures. En revanche, pour ECMAScript 2015 (ES6) et les versions ultérieures où la méthode Array.prototype.keys()
existe, lorsqu'on utilise un environnement créé avec with
, "keys"
serait désormais la méthode et non la variable. C'est là que le symbole natif @@unscopables
Array.prototype[@@unscopables]
intervient et empêche d'explorer ces méthodes avec with
.
var keys = [];
with (Array.prototype) {
keys.push("something");
}
Object.keys(Array.prototype[Symbol.unscopables]);
// ["copyWithin", "entries", "fill", "find", "findIndex",
// "includes", "keys", "values"]
Spécifications
Specification |
---|
ECMAScript Language Specification # sec-array.prototype-%symbol.unscopables% |
Compatibilité des navigateurs
BCD tables only load in the browser