handler.preventExtensions()

概要

Object.preventExtensions()に対するトラップです。

構文

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

引数

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

target

ターゲットオブジェクト

戻り値

preventExtensions メソッドはboolean値を返さなければなりません。

説明

handler.preventExtensions() メソッドは Object.preventExtensions()に対するトラップです。

インターセプト

このトラップは下記の操作をインターセプトできます。:

• Object.preventExtensions()
• Reflect.preventExtensions()

不変条件

次の不変条件に違反している場合、プロキシはTypeErrorをスローします。:

• Object.isExtensible(proxy)がfalseなら、Object.preventExtensions(proxy)はtrueを返すだけです。

例

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

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

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

次のコードでは不変条件に違反します。

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

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

仕様

ブラウザ実装状況

関連情報

• Proxy
• handler
• Object.preventExtensions()
• Reflect.preventExtensions()