Segments.prototype[Symbol.iterator]()

基线 2024

最新可用

自 2024 年 4 月起，此功能在最新的设备和浏览器版本中运行。此功能可能无法在旧设备或浏览器中运行。

的 [Symbol.iterator]() 方法 Segments 实例实现了 可迭代协议 并允许 Segments 对象被大多数期望可迭代的语法使用，例如 扩展语法 和 for...of 循环。它返回一个 段迭代器对象，它会生成有关每个段的数据。

尝试一下

语法

js
segments[Symbol.iterator]()

参数

无。

返回值

一个新的 可迭代迭代器对象，它会生成有关每个段的数据。每个生成的具有与由 containing() 方法返回的对象相同的属性。

示例

使用 for...of 循环迭代

请注意，您很少需要直接调用此方法。[Symbol.iterator]() 方法的存在使 Segments 对象 可迭代，并且像 for...of 循环这样的迭代语法会自动调用此方法以获取要循环的迭代器。

js
const segmenter = new Intl.Segmenter("zh-CN", { granularity: "word" });
const input = "你好，世界！我爱编程。";

for (const value of segmenter.segment(input)) {
  console.log(value);
}

/*
{segment: '你好', index: 0, input: '你好，世界！我爱编程。', isWordLike: true}
{segment: '，', index: 2, input: '你好，世界！我爱编程。', isWordLike: false}
{segment: '世界', index: 3, input: '你好，世界！我爱编程。', isWordLike: true}
{segment: '！', index: 5, input: '你好，世界！我爱编程。', isWordLike: false}
{segment: '我', index: 6, input: '你好，世界！我爱编程。', isWordLike: true}
{segment: '爱', index: 7, input: '你好，世界！我爱编程。', isWordLike: true}
{segment: '编', index: 8, input: '你好，世界！我爱编程。', isWordLike: true}
{segment: '程', index: 9, input: '你好，世界！我爱编程。', isWordLike: true}
{segment: '。', index: 10, input: '你好，世界！我爱编程。', isWordLike: false}
*/

手动滚动迭代器

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

js
const segmenter = new Intl.Segmenter("fr", { granularity: "word" });
const input = "Moi ? N'est-ce pas ?";
const segments = segmenter.segment(input);
const iterator = segments[Symbol.iterator]();

let result = iterator.next();

while (!result.done) {
  console.log(result.value);
  result = iterator.next();
}

/*
{segment: 'Moi', index: 0, input: "Moi ? N'est-ce pas ?", isWordLike: true}
{segment: ' ', index: 3, input: "Moi ? N'est-ce pas ?", isWordLike: false}
{segment: '?', index: 4, input: "Moi ? N'est-ce pas ?", isWordLike: false}
{segment: ' ', index: 5, input: "Moi ? N'est-ce pas ?", isWordLike: false}
{segment: "N'est", index: 6, input: "Moi ? N'est-ce pas ?", isWordLike: true}
{segment: '-', index: 11, input: "Moi ? N'est-ce pas ?", isWordLike: false}
{segment: 'ce', index: 12, input: "Moi ? N'est-ce pas ?", isWordLike: true}
{segment: ' ', index: 14, input: "Moi ? N'est-ce pas ?", isWordLike: false}
{segment: 'pas', index: 15, input: "Moi ? N'est-ce pas ?", isWordLike: true}
{segment: ' ', index: 18, input: "Moi ? N'est-ce pas ?", isWordLike: false}
{segment: '?', index: 19, input: "Moi ? N'est-ce pas ?", isWordLike: false}
*/

规范

规范
ECMAScript 国际化 API 规范
# sec-%intlsegmentsprototype%-%symbol.iterator%

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅