跨域传递迭代器对象必然丢失属性，因其不可序列化且结构化克隆会清空方法、symbol、访问器、状态等；正确做法是只传递可重建的索引、数据源标识和上下文参数。
跨域窗口间传递带有特殊描述符的迭代器对象时，属性丢失不是“偶然问题”，而是浏览器强制执行的结构化克隆限制导致的必然结果。迭代器对象（如 Array.prototype[Symbol.iterator]() 返回的对象、生成器函数返回的 Generator 实例）本身不可序列化——它们内部状态（如闭包变量、执行上下文、next() 方法逻辑）无法被结构化克隆算法捕获。加上若该对象还通过 Object.defineProperty 设置了 writable: false、enumerable: false 或 get/set 描述符，这些元信息在 postMessage() 传输中会全部清空，只留下一个空对象 {} 或 { done: true } 这类极简快照。
真正能跨域传递的，只有可序列化的纯数据，不是行为、状态或访问逻辑。
明确哪些内容会在跨域传递中消失
- 迭代器的
next()、return()、throw()方法（函数不可克隆） -
Symbol.iterator属性（Symbol 类型不支持克隆） - 所有
get/set访问器定义的响应式逻辑 -
Object.freeze()或Object.seal()的状态标记 - 不可枚举属性（
enumerable: false）和私有键（如_state） - 闭包捕获的局部变量、生成器暂停点等运行时状态
你看到的“对象还在”，只是结构化克隆后的一个无行为、无状态、无描述符的数据壳子。
正确做法：传数据，不传迭代器
不要试图把迭代器实例本身发过去。应拆解其语义，只传递可重建的信息：
- 当前迭代位置（如索引
i、游标cursorId、时间戳lastSeenAt） - 原始数据源标识（如
listId: 'orders-2026-Q2'、queryKey: ['users', { role: 'admin' }]） - 必需的上下文参数（如分页大小
limit: 20、过滤条件filter: { status: 'active' }）
示例：
// 发送端：不传 iterator，传可重建的线索
targetWindow.postMessage({
type: 'ITERATE_USERS',
payload: {
listId: 'user_cache_v3',
offset: 40,
limit: 10,
filter: { active: true }
}
}, origin);
接收端按需本地重建迭代逻辑
接收方收到后，不尝试还原原迭代器，而是：
- 查找本地对应的数据源（缓存、IndexedDB、内存数组）
- 根据
offset/limit/filter构造新迭代器或直接切片数据 - 若需流式处理，用
for...of或手动调用next()，但全程在本域内运行
// 接收端
if (msg.data.type === 'ITERATE_USERS') {
const { listId, offset, limit, filter } = msg.data.payload;
const dataSource = LocalStore.get(listId); // 本地已有数据
const items = dataSource
.filter(item => matchesFilter(item, filter))
.slice(offset, offset + limit);
// 直接返回这批数据，或包装成轻量迭代器（仅本域有效）
replyWindow.postMessage({
type: 'ITERATION_RESULT',
payload: { items, hasMore: dataSource.length > offset + limit }
}, event.origin);
}
补充建议：避免混淆“可迭代对象”和“迭代器对象”
- ✅ 可迭代对象（如数组、Map、自定义含
Symbol.iterator方法的对象）可以安全传递其序列化数据（如Array.from(arr)后再structuredClone），因为重点是值，不是遍历过程。 - ❌ 迭代器对象（调用
arr[Symbol.iterator]()得到的那个对象）永远不要传——它本质是临时状态机，跨域即失效。
如果业务强依赖“远程控制迭代进度”，应改用基于消息的请求-响应协议（如发 NEXT 指令，对方查本地状态后返回下一批），而非试图共享迭代器实例。
