Symbol.unscopables

Symbol.unscopables ウェルノウンシンボルは、関連するオブジェクトの with 環境バインディングから除外される自身および継承したプロパティ名のオブジェクト値を指定するために使用されます。

説明

@@unscopables シンボル（Symbol.unscopables）は、with 環境バインディングでレキシカル変数として公開されているプロパティ名を除外するために、任意のオブジェクトで定義できます。Strict モードを使用している場合、with ステートメントは使用不可のため、このシンボルを使う必要がありません。

unscopables オブジェクトでプロパティを true に設定すると、unscopable になります。それゆえ、レキシカルスコープ変数に現れません。プロパティを false に指定すると scopable になりレキシカルスコープ変数に現れます。

例

次のコードは、ES5 以下であれば正しく動作します。しかし、ECMAScript 2015（ES6）以降では、Array.prototype.keys() メソッドが導入されました。これは、with 環境内で "keys" はメソッドであり変数ではないことを意味します。これが unscopable シンボルを導入すべき時です。ビルトイン unscopables 設定は、配列のメソッドのいくつかが with 環境のスコープに入らないようにするために、Array.prototype[@@unscopables] として実装されています。

var keys = [];

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

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

オブジェクトに対して unscopables を設定することもできます。

var obj = { 
  foo: 1, 
  bar: 2 
};

obj[Symbol.unscopables] = { 
  foo: false, 
  bar: true 
};

with(obj) {
  console.log(foo); // 1
  console.log(bar); // ReferenceError: bar is not defined
}

仕様

ブラウザ実装状況

関連項目

• Array.prototype[@@unscopables]
• with ステートメント（Strict モードでは使用不可）