MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

handler.getOwnPropertyDescriptor()

この翻訳は不完全です。英語から この記事を翻訳 してください。

これは Harmony(ECMAScript 6) 提案の一部であり、実験段階の技術です。
この技術の仕様は安定していません。ブラウザ互換性の一覧表を確認してください。またこれらの構文や動作は、仕様変更などにより、新しいバージョンのブラウザでは変更される可能性があるという点に注意してください。

概要

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

構文

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

引数

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

target
ターゲットオブジェクト
prop
説明が取得されるプロパティの名称

戻り値

getOwnPropertyDescriptor メソッドはオブジェクトまたはundefinedを返さなければなりません。

説明

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

インターセプト

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

不変条件

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

  • getOwnPropertyDescriptorはオブジェクトまたはundefinedを返さなければなりません。
  • プロパティが非設定な独自のターゲットオブジェクトのプロパティとして存在するなら、存在しないとして報告されてはいけません。
  • プロパティがターゲットオブジェクトの独自プロパティとして存在し、そのターゲットオブジェクトが拡張可能でないなら、存在しないとして報告されてはいけません。
  • プロパティがターゲットオブジェクトの独自プロパティとして存在せず、そのターゲットオブジェクトが拡張可能でないなら、存在するとして報告されてはいけません。
  • プロパティがターゲットオブジェクトの独自プロパティとして存在しない、または、ターゲットオブジェクトの定可能な独自のプロパティとして存在しているなら、非設定であるとして報告されてはいけません。
  • Object.getOwnPropertyDescriptor(target)の結果がObject.definePropertyを使用してターゲットオブジェクトに適用でき、例外をスローしません。

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

var p = new Proxy({ a: 20 }, {
  getOwnPropertyDescriptor: function(target, prop) {
    console.log("called: " + prop);
    return { configurable: true, enumerable: true, value: 10 };
  }
});

console.log(Object.getOwnPropertyDescriptor(p, "a").value); // "called: a"
                                                            // 10

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

var obj = { a: 10 };
Object.preventExtensions(obj);
var p = new Proxy(obj, {
  getOwnPropertyDescriptor: function(target, prop) {
    return undefined;
  }
});

Object.getOwnPropertyDescriptor(p, "a"); // TypeError is thrown

仕様

仕様 状況 コメント
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of '[[GetOwnProperty]]' in that specification.
Standard Initial definition.

ブラウザ実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート ? 18 (18) ? ? ?
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート ? ? 18.0 (18) ? ? ?

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: shide55
 最終更新者: shide55,