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

handler.ownKeys()

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

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

概要

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

構文

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

引数

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

target
ターゲットオブジェクト

戻り値

ownKeys メソッドは反復オブジェクトを返さなければなりません。

説明

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

インターセプト

このトラップは下記の操作をトラップできます。:

不変条件

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

  • ownKeysの結果はリストです。
  • 結果リストのそれぞれの要素の型はString または Symbolのどちらかです。
  • 結果リストはターゲットオブジェクトのすべての非設定の独自プロパティのキーを含みます。
  • ターゲットオブジェクトが拡張可能でないなら、結果リストはターゲットオブジェクトのすべての独自プロパティのキーを含まなければなりません。そして、他の値を含みません。

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

var p = new Proxy({}, {
  ownKeys: function(target) {
    console.log("called");
    return ["a", "b", "c"];
  }
});

console.log(Object.getOwnPropertyNames(p)); // "called"

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

var obj = {};
Object.defineProperty(obj, "a", { 
  configurable: false, 
  enumerable: true, 
  value: 10 }
);

var p = new Proxy(obj, {
  ownKeys: function(target) {
    return [];
  }
});

console.log(Object.getOwnPropertyNames(p)); // TypeError is thrown

仕様

仕様 状況 コメント
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of '[[OwnPropertyKeys]]' 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,