Symbol.unscopables

Le symbole connu Symbol.unscopables est utilisé afin de définir les noms des propriétés propres et héritées qui sont exclues de l'objet lors de l'utilisation de with sur l'objet en question.

Dans cet article

Exemple interactif

const object1 = {
  property1: 42,
};

object1[Symbol.unscopables] = {
  property1: true,
};

with (object1) {
  console.log(property1);
  // Expected output: Error: property1 is not defined
}

Le symbole @@unscopables (Symbol.unscopables) peut être défini sur n'importe quel objet afin de ne pas exposer certaines propriétés lors des liaisons lexicales avec with. Note : en mode strict, l'instruction with n'est pas disponible et ce symbole est donc probablement moins nécessaire.

En définissant une propriété comme true dans un objet unscopables, cela exclura la propriété de la portée lexicale. En définissant une propriété comme false, celle-ci pourra faire partie de la portée lexicale et être manipulée dans un bloc with.

Attributs de Symbol.unscopables

Écrivable	Non
Énumérable	Non
Configurable	Non

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.

js
var keys = [];

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

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

On peut également manipuler unscopables sur ses propres objets :

js
var obj = {
  toto: 1,
  truc: 2,
};

obj[Symbol.unscopables] = {
  toto: false,
  truc: true,
};

with (obj) {
  console.log(toto); // 1
  console.log(truc); // ReferenceError: truc is not defined
}

Array.prototype[@@unscopables]
L'instruction with (qui n'est pas disponible en mode strict)

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 17 févr. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Objets natifs standards
Symbol
Constructeur
1. Constructeur Symbol()
Méthodes statiques
1. Symbol.for()
2. Symbol.keyFor()
Propriétés statiques
Méthodes d'instance
Propriétés d'instance
1. Symbol.prototype.description
Héritage
Object/Function
Méthodes statiques
Propriétés statiques
Méthodes d'instance
Propriétés d'instance
1. Object.prototype.__proto__
2. Object.prototype.constructor

Symbol.unscopables

Dans cet article

Exemple interactif

Description

Exemples

Spécifications

Compatibilité des navigateurs

Voir aussi

Aider à améliorer MDN