symbol.unscopables仅控制with语句中属性是否被注入词法作用域,不提供任何安全保护;其值为对象,键为属性名、值为布尔值,true表示该属性在with块内不可通过标识符访问,但所有其他访问方式(如obj.prop、reflect、继承等)均不受影响。

Symbol.unscopables 的设计目的不是保护敏感属性,也不参与继承链控制,更无法防止属性泄露。它仅影响 with 语句的作用域绑定行为,且现代 JavaScript 已基本弃用 with。试图用它实现“属性保护”属于误用,无法达成安全目标。
Symbol.unscopables 的真实作用
该 symbol 对应一个对象,其键为字符串属性名,值为布尔值:
- 若某属性名对应 true,则在 with 块中该属性**不会被自动注入到词法作用域**;
- 它只改变标识符解析路径,不阻止属性访问、枚举、反射或继承。
例如:
const obj = {
public: 'ok',
secret: 'hidden',
[Symbol.unscopables]: { secret: true }
};
<p>with (obj) {
console.log(public); // ✅ 正常输出 'ok'
console.log(secret); // ❌ ReferenceError:secret 未定义(仅限 with 内部)
}</p>但以下所有操作仍可完全访问 secret:
obj.secretObject.keys(obj)Reflect.ownKeys(obj)JSON.stringify(obj)- 子类继承后
instance.secret照常可读
继承链中它不起保护作用
即使在原型链上设置 Symbol.unscopables,子对象或实例依然能正常读取、覆盖、遍历该属性。它不阻断 get、has 或 in 操作,也不影响 Object.getOwnPropertyDescriptors 或 for...in。
例如:
const parent = {
token: 'abc123',
[Symbol.unscopables]: { token: true }
};
const child = Object.create(parent);
<p>with (child) {
token; // ❌ ReferenceError
}
child.token; // ✅ 'abc123' —— 完全可访问
'token' in child; // ✅ true
Object.keys(child); // ✅ [](因为是继承的,但 get 依然有效)</p>真正可行的敏感属性保护方式
若需限制属性暴露,应使用语言原生的访问控制机制:
- 私有字段(#field):ES2022+ 标准语法,真正不可外部访问,不参与继承(子类无法直接读写父类私有字段)
- WeakMap 封装:将敏感数据存于闭包外的 WeakMap,键为实例,实现运行时隔离
-
Proxy 拦截:对
get/has/ownKeys等 trap 进行过滤,可统一控制继承链上的可见性 -
不可枚举 + 不可配置:用
Object.defineProperty设置enumerable: false, configurable: false,至少隐藏于for...in和JSON.stringify
为什么不推荐依赖 unscopables 做安全防护
它既无运行时强制力,也不被任何安全模型(CSP、realm、VM 沙箱)识别;
Node.js、浏览器 DevTools、序列化工具、调试器均无视该 flag;
代码压缩、转译(如 Babel)可能意外移除或忽略它;
且 with 本身在严格模式下被禁用,实际执行环境几乎为零。










