Array.prototype[@@unscopables]

@@unscopable シンボルプロパティには、ES2015（ES6）以前の ECMAScript 標準には含まれていないプロパティ名があります。それらのプロパティは、with ステートメントバインディングから除外されます。

構文

arr[Symbol.unscopables]

説明

with バインディングから除外される既定の配列プロパティは次のとおりです：copyWithin と entries、fill、find、findIndex、includes、keys、values。

自作オブジェクトに unscopables を設定する方法については、Symbol.unscopables を見てください。

例

次のコードは、ES5 以下であれば正常に動作します。しかし、ECMAScript 2015（ES6）以降では Array.prototype.keys() メソッドが導入されました。つまり、with 環境内では、"keys" はメソッドであり、変数ではありません。ここがビルトイン @@unscopables の役立つ場所です。Array.prototype[@@unscopables] シンボルプロパティが使用されると、配列のいくつかのメソッドが with ステートメントのスコープに入ることを防ぎます。

var keys = [];

with(Array.prototype) {
  keys.push("something");
}

Object.keys(Array.prototype[Symbol.unscopables]); 
// ["copyWithin", "entries", "fill", "find", "findIndex", 
//  "includes", "keys", "values"]

仕様

ブラウザ実装状況

関連項目

• Symbol.unscopables