String.prototype[Symbol.iterator]()

[Symbol.iterator]() 方法是 String 值的 可迭代协议 实现，并允许字符串被大多数期望可迭代对象的语法使用，例如 扩展语法 和 for...of 循环。它返回一个 字符串迭代器对象，该对象将字符串值的 Unicode 代码点作为单独的字符串逐个生成。

尝试一下

语法

js
string[Symbol.iterator]()

参数

无。

返回值

一个新的 可迭代迭代器对象，它将字符串值的 Unicode 代码点作为单独的字符串逐个生成。

描述

字符串按 Unicode 代码点进行迭代。这意味着字形簇将被拆分，但代理对将被保留。

js
// "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 循环这样的迭代语法会自动调用此方法以获取要循环的迭代器。

js
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() 方法，以实现对迭代过程的最大控制。

js
const str = "A\uD835\uDC68";

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

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

规范

规范
ECMAScript 语言规范
# sec-string.prototype-%symbol.iterator%

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅