大网数据广告活动
Web 标准与前端开发

String.prototype[Symbol.iterator]()

· 52CE 我爱测

String 值的 **`Symbol.iterator`** 方法实现了可迭代协议,并允许字符串与大多数期望传入可迭代对象的语法一起使用,例如展开语法和 Statements/for...of 循环。它返回一个字符串迭代器对象,它按 Unicode 码位迭代字符串值并以字符串的形式返回。

String 值的 [Symbol.iterator]() 方法实现了可迭代协议,并允许字符串与大多数期望传入可迭代对象的语法一起使用,例如展开语法和 Statements/for...of 循环。它返回一个字符串迭代器对象,它按 Unicode 码位迭代字符串值并以字符串的形式返回。

JavaScript Demo: String.prototypeSymbol.iterator

const str = "The quick red fox jumped over the lazy dog's back.";

const iterator = str[Symbol.iterator]();
let theChar = iterator.next();

while (!theChar.done && theChar.value !== " ") {
  console.log(theChar.value);
  theChar = iterator.next();
  // Expected output: "T"
  //                  "h"
  //                  "e"
}

语法

string[Symbol.iterator]()

返回值

一个新的可迭代迭代器对象,它以字符串值中的 Unicode 码位生成单独的字符串。

描述

按 Unicode 码位迭代字符串。这意味着会将字素簇拆分,但代理对将被保留。

// "Backhand Index Pointing Right: Dark Skin Tone"
[..."👉🏿"]; // ['👉', '🏿']
// splits into the basic "Backhand Index Pointing Right" emoji and
// the "Dark skin tone" emoji

// "Family: Man, Boy"
[..."👨‍👦"]; // [ '👨', '‍', '👦' ]
// splits into the "Man" and "Boy" emoji, joined by a ZWJ

示例

使用 for...of 循环进行迭代

请注意,你很少需要直接调用该方法。[Symbol.iterator]() 方法的存在使得字符串可迭代,而像 for...of 循环这样的迭代语法会自动调用该方法以获取迭代器进行循环。

const str = "A\uD835\uDC68B\uD835\uDC69C\uD835\uDC6A";

for (const v of str) {
  console.log(v);
}
// "A"
// "\uD835\uDC68"
// "B"
// "\uD835\uDC69"
// "C"
// "\uD835\uDC6A"

手动迭代

你仍然可以手动调用返回的迭代器对象的 next() 方法,以实现对迭代过程最大程度的控制。

const str = "A\uD835\uDC68";

const strIter = str[Symbol.iterator]();

console.log(strIter.next().value); // "A"
console.log(strIter.next().value); // "\uD835\uDC68"

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。