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.

handler.preventExtensions() はオブジェクトの [[PreventExtensions]] 内部メソッドに対するトラップです。 Object.preventExtensions() のような操作で使用されます。

試してみましょう

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

構文

js
new Proxy(target, {
  preventExtensions(target) {
  }
});

引数

次の引数は preventExtensions() メソッドに渡されます。 this はハンドラーにバインドされます。

target

ターゲットオブジェクトです。

返値

preventExtensions() メソッドは論理値を返さなければなりません。

解説

介入

このトラップは下記の操作に介入できます。

他にも、[[PreventExtensions]] 内部メソッドを呼び出すあらゆる操作に介入できます。

不変条件

以下の不変条件に違反している場合、プロキシーは TypeError を発生します。

  • Object.preventExtensions(proxy) は、 Object.isExtensible(proxy) が false の場合のみ true を返します。

例

preventExtensions のトラップ

次のコードでは Object.preventExtensions() をトラップします。

js
const p = new Proxy(
  {},
  {
    preventExtensions(target) {
      console.log("called");
      Object.preventExtensions(target);
      return true;
    },
  },
);

console.log(Object.preventExtensions(p));
// "called"
// false

以下のコードは不変条件に違反しています。

js
const p = new Proxy(
  {},
  {
    preventExtensions(target) {
      return true;
    },
  },
);

Object.preventExtensions(p); // TypeError is thrown

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser

関連情報