讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

ES6 Proxy 实现自迭代数组的完整教程

酷静吖_2026

酷静吖_2026

发布时间:2026-01-30 16:56:01

|

444人浏览过

|

来源于php中文网

原创

ES6 Proxy 实现自迭代数组的完整教程

本文详解如何通过 es6 proxy 创建一个能被 `for...of` 正确遍历的“自引用可迭代数组”,核心在于拦截 `symbol.iterator` 等 symbol 属性,确保代理对象满足迭代协议。

在 JavaScript 中,for...of 循环并非简单检查对象是否有 length 或是否为数组,而是严格遵循迭代协议(Iteration Protocol):它会尝试读取目标对象的 Symbol.iterator 方法,并调用其返回一个迭代器对象。若代理未显式暴露该 symbol 属性,即使底层是数组,for...of 仍会报错 is not iterable。

你原始代码的问题正在于此:get 拦截器只处理了字符串属性(如 'length'、'push'),却忽略了所有 Symbol 类型的 key(包括 Symbol.iterator、Symbol.toStringTag 等)。当 for (let v of p.any) 执行时,引擎实际发出的是 p.any[Symbol.iterator]() 调用,而你的逻辑返回了 p(即另一个 Proxy),而非一个合法迭代器函数——导致 TypeError。

✅ 正确解法是:允许 Symbol 属性直接委托给原数组,同时确保数组初始即包含自身引用,从而形成“自迭代”结构:

JSON Toolkit
JSON Toolkit

JSON文件多功能工具。支持格式化、验证、压缩、键排序及点记法路径查询。零依赖。

下载
const p = new Proxy([], {
  get(obj, prop) {
    // ✅ 关键:对 Symbol 属性(含 Symbol.iterator)一律透传
    if (typeof prop === 'symbol') {
      return obj[prop];
    }
    // ✅ 首次访问任意属性时,向原数组插入自身(避免重复 push)
    if (obj.length === 0) {
      obj.push(p);
    }
    // ✅ 显式放行关键数组自有属性
    if (prop === 'length' || prop === 'push' || 
        prop === 'forEach' || prop === 'map' || 
        prop === 'filter' || prop === 'reduce') {
      return obj[prop];
    }
    // ❌ 其他字符串属性均返回代理自身(实现链式“any”访问)
    return p;
  }
});

现在验证效果:

// ✅ 可被 for...of 遍历,输出一次 p(即自身)
for (let v of p) {
  console.log(v === p); // true
}

// ✅ 支持嵌套访问,每一层都是同一代理实例
console.log(p.any === p);        // true
console.log(p.any.any === p);    // true

// ✅ 原生数组方法可用(因 push/forEach 等已透传)
p.push('extra');
console.log(p); // [p, 'extra']

// ✅ toString()、JSON.stringify 等也更健壮(可选增强:拦截 Symbol.toStringTag)

⚠️ 注意事项:

  • 不要写 p.push(p)(p 是代理,非原数组),应操作 obj.push(p) —— 这是 get 的第二个参数,指向被代理的原始目标对象;
  • 若需支持 Array.isArray(p) 返回 true,可额外拦截 Symbol.toStringTag 并返回 'Array';
  • 生产环境慎用此模式:无限自引用可能导致调试困难或 JSON 序列化崩溃(JSON.stringify(p) 会抛出 TypeError: Converting circular structure to JSON);
  • 如需兼容更多数组方法(如 flat()、at()),应在 get 中补充对应字符串属性透传。

总结:Proxy 的 get 拦截器必须主动识别并透传 Symbol 属性,尤其是 Symbol.iterator,这是让自定义对象融入 JavaScript 迭代生态的必要条件。掌握这一原则,你就能灵活构建符合语言协议的响应式、递归或虚拟数据结构。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2335

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3842

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1276

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4459

2025.09.10

es6新特性
es6新特性

es6新特性有:1、块级作用域变量;2、箭头函数;3、模板字符串;4、解构赋值;5、默认参数;6、 扩展运算符;7、 类和继承;8、Promise。本专题为大家提供es6新特性的相关的文章、下载、课程内容,供大家免费下载体验。

305

2023.07.17

es6新特性有哪些
es6新特性有哪些

es6的新特性有:1、块级作用域;2、箭头函数;3、解构赋值;4、默认参数;5、扩展运算符;6、模板字符串;7、类和模块;8、迭代器和生成器;9、Promise对象;10、模块化导入和导出等等。本专题为大家提供es6新特性的相关的文章、下载、课程内容,供大家免费下载体验。

406

2023.08.04

JavaScript ES6新特性
JavaScript ES6新特性

ES6是JavaScript的根本性升级,引入let/const实现块级作用域、箭头函数解决this绑定问题、解构赋值与模板字符串简化数据处理、对象简写与模块化提升代码可读性与组织性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

395

2025.12.24

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1938

2023.08.03

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

20

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.5万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn