Array.prototype[@@unscopables]

以下の名前で true に設定された null プロトタイプオブジェクトです。

Array プロパティのうち、既定で with 文のバインディング目的では無視されるものは次のとおりです。

• at()
• copyWithin()
• entries()
• fill()
• find()
• findIndex()
• findLast()
• findLastIndex()
• flat()
• flatMap()
• includes()
• keys()
• toReversed()
• toSorted()
• toSpliced()
• values()

Array.prototype[@@unscopables] は、上記のプロパティ名をすべて true の値で持つ、空のオブジェクトです。このプロトタイプは null なので、 Object.prototype のプロパティ、例えば toString は偶然にスコープ付けできなくなることはなく、 with 文の中の toString() は引き続き配列の中で呼び出すことができます。

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

ECMAScript 2015 以前に書かれた以下のコードで keys.push('something') を呼び出すことを考えてみてください。

var keys = [];

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

ECMAScript 2015 で Array.prototype.keys() メソッドが導入されたとき、もし @unscopables データプロパティも導入されていなければ、 keys.push('something') の呼び出しは壊れていました。 JavaScript ランタイムが keys を Array.prototype.keys() メソッドであると解釈し、この例のコードで定義された配列 keys とは解釈しませんでした。

すなわち、 @unscopables データプロパティが Array.prototype にあるのは、 ECMAScript 2015 で導入された Array プロパティを with 文のバインドの目的では無視するようにし、 ECMAScript 2015 以前に書かれたコードを壊さず、期待どおりに動作し続けられるようにするものです。

• Array.prototype[@@unscopables] のポリフィル (core-js)
• インデックス付きコレクションガイド
• Array
• with
• Symbol.unscopables