handler.getPrototypeOf()

Summary

[[GetPrototypeOf]] 内部メソッドに対するトラップです。

構文

var p = new Proxy(obj, {
  getPrototypeOf(target) {
  ...
  }
});

引数

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

target

ターゲットオブジェクト

戻り値

getPrototypeOf メソッドはオブジェクトかnullを返さなければなりません。

説明

インターセプト

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

• Object.getPrototypeOf()
• Reflect.getPrototypeOf()
• __proto__
• Object.prototype.isPrototypeOf()
• instanceof

不変条件

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

• getPrototypeOf メソッドはオブジェクトまたはnullを返さなければなりません。
• targetが拡張可能でないなら、Object.getPrototypeOf(proxy) メソッドはObject.getPrototypeOf(target)と同じ値を返さなければなりません。

例

例: 基本的な使用

var obj = {};
var proto = {};
var handler = {
    getPrototypeOf(target) {
        console.log(target === obj);   // true
        console.log(this === handler); // true
        return proto;
    }
};

var p = new Proxy(obj, handler);
console.log(Object.getPrototypeOf(p) === proto);    // true

例: きっかけとなってgetPrototypeOfのトラップが起こる５つの方法

var obj = {};
var p = new Proxy(obj, {
    getPrototypeOf(target) {
        return Array.prototype;
    }
});
console.log(
    Object.getPrototypeOf(p) === Array.prototype,  // true
    Reflect.getPrototypeOf(p) === Array.prototype, // true
    p.__proto__ === Array.prototype,               // true
    Array.prototype.isPrototypeOf(p),              // true
    p instanceof Array                             // true
);

例: ２種類の例外

var obj = {};
var p = new Proxy(obj, {
    getPrototypeOf(target) {
        return "foo";
    }
});
Object.getPrototypeOf(p); // TypeError: "foo" is not an object or null

var obj = Object.preventExtensions({});
var p = new Proxy(obj, {
    getPrototypeOf(target) {
        return {};
    }
});
Object.getPrototypeOf(p); // TypeError: expected same prototype value

仕様

ブラウザ実装状況

関連情報

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