Symbol.unscopables仅在with语句中临时排除指定属性名的自动变量绑定,需对象自身显式定义且值为对象,不可枚举不可写,但不影响常规属性访问。

Symbol.unscopables 不是“锁定”变量查找范围,它只是在 with 语句执行时,**临时排除某些属性名从词法作用域中自动绑定**。识别它的生效逻辑,关键在于理解它何时起作用、对谁起作用、以及怎么验证。
看对象自身是否定义了 Symbol.unscopables
该 symbol 必须显式存在于目标对象自身(Object.hasOwn(obj, Symbol.unscopables) 为 true),不会从原型链继承。即使父类设置了,子类实例或派生对象也需自己设置才有效。
- 用
obj[Symbol.unscopables]直接读取,存在且为对象才可能生效 - 检查该对象的
Symbol.unscopables属性是否可枚举:它默认不可枚举(enumerable: false),所以Object.keys(obj)或for...in看不到它 - 注意:该属性本身不可写、不可配置(但值对象内部的布尔字段可改)
看 with 块中能否用裸变量名访问被标记的属性
这是最直接的识别方式:把对象传入 with,然后尝试以变量形式引用其属性。
- 若某属性名(如
bar)在[Symbol.unscopables]: { bar: true }中被设为true,则with(obj) { bar }会抛ReferenceError - 若设为
false或未声明,则该变量名可在with内正常访问(前提是不与外层同名变量冲突) - 注意:严格模式下
with语法非法,此测试必须在非严格模式运行
看属性是否仍可通过常规方式访问
Symbol.unscopables 完全不影响其他任何访问路径——这是判断它是否“起效”的反向验证点。
-
obj.bar、obj['bar']、'bar' in obj、obj.hasOwnProperty('bar')全部照常工作 -
Object.keys(obj)、Reflect.ownKeys(obj)、for (let k in obj)都能列出bar - 哪怕
bar在with中不可见,它仍是公开属性,无任何封装或私有性保障
看 Array.prototype 等内置对象的典型用例
对照标准行为,能快速建立直觉。例如:
-
Array.prototype[Symbol.unscopables]包含keys、values、includes等键,值均为true -
with ([1,2,3]) { console.log(keys()); }会报错(keys is not defined),但[1,2,3].keys()正常 - 这说明屏蔽只发生在
with的变量绑定阶段,不修改方法存在性或调用能力

















