Array.prototype[@@unscopables]

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

解説

with バインディングから除外される既定の配列プロパティは次のとおりです。

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

Array.prototype[@@unscopables] のプロパティ属性
書込可能 不可
列挙可能 不可
設定可能

with 環境内での使用

次のコードは、 ES5 以下であれば正常に動作します。しかし、 ECMAScript 2015 以降では 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"]

仕様書

仕様書
ECMAScript (ECMA-262)
Array.prototype[@@unscopables] の定義

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
@@unscopablesChrome 完全対応 38Edge 完全対応 12Firefox 完全対応 48IE 未対応 なしOpera 完全対応 25Safari 完全対応 10WebView Android 完全対応 38Chrome Android 完全対応 38Firefox Android 完全対応 48Opera Android 完全対応 25Safari iOS 完全対応 10Samsung Internet Android 完全対応 3.0nodejs 完全対応 0.12

凡例

完全対応  
完全対応
未対応  
未対応

関連情報