什么是 Shadow Realm 提案，它为何被认为是比 iframe 更安全的代码隔离方案？

Shadow Realm 是 ECMAScript 规范中正在推进的一项提案，它允许在 JavaScript 运行时内创建一个独立的、与主执行环境隔离的上下文，用于执行不受信任或需要隔离的代码，同时避免传统隔离方案的一些缺陷。

什么是 Shadow Realm 提案

Shadow Realm 提案的核心是为 JavaScript 提供一个原生的、轻量级的隔离执行环境，这个环境拥有独立的全局对象、内置对象和原型链，和主执行环境完全隔离，不会互相干扰。

我们可以通过 ShadowRealm 构造函数来创建一个隔离的 Realm 实例，然后在这个实例中执行代码：

// 创建 Shadow Realm 实例
const realm = new ShadowRealm();

// 在隔离环境中执行代码，返回结果
const result = realm.evaluate(`1 + 2`);
console.log(result); // 输出 3

// 也可以在隔离环境中定义函数，通过返回值传递调用能力
const addFunc = realm.evaluate(`(a, b) => a + b`);
console.log(addFunc(2, 3)); // 输出 5

需要注意的是，Shadow Realm 中执行的代码无法直接访问主环境的变量、函数或者 DOM 对象，所有的交互都需要通过显式的通信方式完成，从根源上降低了代码互相影响的风险。

iframe 作为隔离方案的局限性

iframe 是长期以来前端实现代码隔离的常用方案，它通过浏览器提供的文档隔离机制，让嵌入的页面拥有独立的上下文，但本身存在不少安全和管理上的问题：

• iframe 和主页面共享浏览器的部分进程资源，在站点隔离策略不完善的环境下，仍然存在跨上下文攻击的可能
• iframe 的通信依赖 postMessage 等机制，通信过程需要手动处理序列化和反序列化，容易出现数据泄露风险
• iframe 会加载完整的文档环境，包含 DOM、历史记录、导航等大量不需要的能力，攻击面更大
• iframe 的沙箱控制依赖 sandbox 属性配置，配置不当很容易出现权限过度开放的问题

Shadow Realm 比 iframe 更安全的核心原因

1. 更严格的隔离边界

Shadow Realm 是语言层面的隔离，它的全局对象和主环境的全局对象完全独立，没有共享的原型链或者内置对象引用。而 iframe 的全局对象虽然独立，但部分内置对象（如 Array、Object）在部分浏览器实现中可能存在隐式的关联，存在原型链污染的风险。

我们可以通过代码验证两者的隔离差异：

// 主环境修改 Array 原型
Array.prototype.customMethod = () => console.log('main');

// iframe 环境不会受到主环境原型修改的影响，但部分场景下仍有风险
const iframe = document.createElement('iframe');
document.body.appendChild(iframe);
console.log(iframe.contentWindow.Array.prototype.customMethod); // 部分浏览器可能输出函数

// Shadow Realm 完全不受影响
const realm = new ShadowRealm();
const hasMethod = realm.evaluate(`Array.prototype.hasOwnProperty('customMethod')`);
console.log(hasMethod); // 输出 false

2. 更小的攻击面

Shadow Realm 仅提供 JavaScript 核心运行环境，不包含 DOM、BOM 等浏览器特有的 API，执行隔离代码时无法访问页面元素、Cookie、本地存储等敏感资源。而 iframe 即使开启 sandbox 属性，若配置不当仍可能获得部分 DOM 操作权限，存在窃取页面信息的风险。

3. 更可控的通信机制

Shadow Realm 的代码执行结果只能通过返回值传递，且传递的数据会被自动进行结构化克隆，无法传递函数、DOM 节点等引用类型，避免了引用泄露导致的安全问题。而 iframe 的 postMessage 通信可以传递任意可序列化的数据，若开发者未对接收的数据做校验，很容易引发安全问题。

4. 更轻量的资源消耗

Shadow Realm 不需要创建完整的文档环境，资源占用远低于 iframe，同时因为运行在同一个 JavaScript 运行时内，调度效率更高，也减少了因多上下文切换带来的潜在安全问题。

Shadow Realm 的适用场景

Shadow Realm 更适合需要轻量级代码隔离的场景，比如：

• 执行用户上传的自定义 JavaScript 代码片段，如低代码平台的自定义逻辑执行
• 运行第三方插件代码，避免插件污染主应用环境
• 隔离测试代码，避免测试用例之间的全局变量互相影响

不过目前 Shadow Realm 提案还未正式纳入 ECMAScript 标准，部分浏览器还未支持，实际使用时需要关注兼容性情况。

Shadow_Realm代码隔离iframeJavaScript安全修改时间：2026-07-16 01:45:26