Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

handler.isExtensible()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨septembre 2016⁩.

La méthode handler.isExtensible() est une trappe pour intercepter les opérations de Object.isExtensible().

Exemple interactif

const monster1 = {
  canEvolve: true,
};

const handler1 = {
  isExtensible(target) {
    return Reflect.isExtensible(target);
  },
  preventExtensions(target) {
    target.canEvolve = false;
    return Reflect.preventExtensions(target);
  },
};

const proxy1 = new Proxy(monster1, handler1);

console.log(Object.isExtensible(proxy1));
// Expected output: true

console.log(monster1.canEvolve);
// Expected output: true

Object.preventExtensions(proxy1);

console.log(Object.isExtensible(proxy1));
// Expected output: false

console.log(monster1.canEvolve);
// Expected output: false

Syntaxe

js
var p = new Proxy(cible, {
  isExtensible: function (cible) {},
});

Paramètres

Les paramètres suivants sont passés à la méthode isExtensible. this est ici lié au gestionnaire (handler).

cible

L'objet cible.

Valeur de retour

La méthode isExtensible doit renvoyer une valeur booléenne.

Description

La méthode handler.isExtensible() est une trappe pour intercepter Object.isExtensible().

Interceptions

Cette trappe intercepte les opérations suivantes :

Invariants

Si les invariants suivants ne sont pas respectés, le proxy renverra une exception TypeError :

  • Object.isExtensible(proxy) doit renvoyer la même valeur que Object.isExtensible(cible).

Exemples

Dans l'exemple qui suit, on intercepte Object.isExtensible().

js
var p = new Proxy(
  {},
  {
    isExtensible: function (cible) {
      console.log("appelée");
      return true;
    },
  },
);

console.log(Object.isExtensible(p)); // "appelée"
// true

Le code suivante ne respecte pas l'invariant et entraîne donc une exception.

js
var p = new Proxy(
  {},
  {
    isExtensible: function (cible) {
      return false;
    },
  },
);

Object.isExtensible(p); // TypeError est levée

Spécifications

Specification
ECMAScript® 2026 Language Specification
# sec-proxy-object-internal-methods-and-internal-slots-isextensible

Compatibilité des navigateurs

Voir aussi