讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

Seko
Seko

AI短剧一键生成成片

updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

ES6 Proxy 实现可迭代数组的正确方式

秋明小哥_4143

秋明小哥_4143

发布时间:2026-01-30 13:30:02

|

484人浏览过

|

来源于php中文网

原创

ES6 Proxy 实现可迭代数组的正确方式

本文讲解如何使用 es6 proxy 创建一个始终返回自身(且可被 for...of 正确遍历)的代理数组,关键在于拦截 `symbol.iterator` 等内置符号属性,而非仅处理字符串键。

在 JavaScript 中,for...of 循环并非简单访问 length 或调用 push,而是依赖对象是否具备有效的 Symbol.iterator 方法——即该对象是否实现了可迭代协议(iterable protocol)。当你用 Proxy 包裹空数组并返回自身(如 return p)时,若未显式透传 Symbol.iterator,for...of 就会因找不到合法迭代器而抛出 TypeError: ... is not iterable。

✅ 正确做法:透传 Symbol 属性与关键数组方法

核心原则是:所有 symbol 类型的属性(尤其是 Symbol.iterator)必须原样返回目标对象(obj)上的对应值;同时,首次访问时自动将代理自身推入数组,确保 length === 1 且内容为循环引用。

JSON Toolkit
JSON Toolkit

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

下载

以下是完整、健壮的实现:

const p = new Proxy([], {
  get(obj, prop) {
    // 首次访问任意属性时,向原数组中推入自身(确保 length === 1)
    if (obj.length === 0) {
      obj.push(p);
    }
    // 透传所有 Symbol 属性(含 Symbol.iterator、Symbol.toStringTag 等)
    // 以及关键数组方法(避免 for...of / Array.isArray / JSON.stringify 失败)
    if (typeof prop === 'symbol' || 
        ['length', 'push', 'pop', 'forEach', 'map', 'filter', 'reduce', 'toString', 'join'].includes(prop)) {
      return obj[prop];
    }
    // 其他任意字符串属性均返回代理自身,形成链式响应
    return p;
  }
});

? 验证效果

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

// ✅ 支持嵌套访问(p.any.any.any... 均为同一代理)
console.log(p.any.any === p); // true

// ✅ 兼容数组常用方法
console.log(p.map(x => x === p)); // [true]
console.log(p.length); // 1
console.log(Array.isArray(p)); // true(因 Proxy 继承自 Array 原型且透传 isArray 所需内部逻辑)

// ✅ JSON 序列化安全(避免循环引用报错)
console.log(JSON.stringify(p, null, 2));
// 输出:[ "[Circular]" ](取决于环境,但不会崩溃)

⚠️ 注意事项

  • 不要写 p.push(p):这会触发 get 拦截器再次执行,导致无限递归。应始终操作原始目标对象 obj.push(p)。
  • 仅透传必要方法:过度透传(如 __proto__、constructor)可能破坏代理语义;聚焦于迭代、长度、基础操作即可。
  • Symbol.iterator 是关键:它是 for...of、扩展运算符([...p])、解构赋值等语法的底层依赖,缺失即失效。
  • 调试提示:可通过 console.dir(p) 查看代理结构,并用 Object.getOwnPropertySymbols(p) 检查符号属性是否可用。

通过精准控制 get 拦截器对 symbol 和关键字符串属性的响应策略,你就能构建出既符合数组语义、又具备“自引用+可迭代”特性的 Proxy 对象——完美适配数据映射层的测试与模拟需求。

热门AI工具

更多
码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

WorkBuddy

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

豆包大模型

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

切问学术

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

DeepSeek

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

音述AI
音述AI Hot

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

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

相关专题

更多
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

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6364

2023.10.24

Go语言中的运算符有哪些
Go语言中的运算符有哪些

Go语言中的运算符有:1、加法运算符;2、减法运算符;3、乘法运算符;4、除法运算符;5、取余运算符;6、比较运算符;7、位运算符;8、按位与运算符;9、按位或运算符;10、按位异或运算符等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3484

2024.02.23

php三元运算符用法
php三元运算符用法

本专题整合了php三元运算符相关教程,阅读专题下面的文章了解更多详细内容。

1932

2025.10.17

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

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

1918

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

3164

2023.09.04

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

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

0

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