handler.preventExtensions()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

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

Exemple interactif

const monster1 = {
  canEvolve: true,
};

const handler1 = {
  preventExtensions(target) {
    target.canEvolve = false;
    Object.preventExtensions(target);
    return true;
  },
};

const proxy1 = new Proxy(monster1, handler1);

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

Object.preventExtensions(proxy1);

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

Syntaxe

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

Paramètres

Le paramètre suivant est passé à la méthode preventExtensions. this est lié au gestionnaire (handler).

cible: L'objet cible.

Valeur de retour

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

Description

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

Interceptions

Cette trappe peut intercepter les opérations de :

Invariants

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

Object.preventExtensions(proxy) ne renvoie true que si Object.isExtensible(proxy) vaut false.

Exemples

On intercepte l'appel à Object.preventExtensions() dans l'exemple suivant :

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

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

Le code suivant ne respecte pas l'invariant :

var p = new Proxy(
  {},
  {
    preventExtensions: function (cible) {
      return true;
    },
  },
);

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

Spécifications

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