Segments.prototype[Symbol.iterator]()
Baseline
2024
Newly available
Since April 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
[Symbol.iterator]() は Segments インスタンスのメソッドで、反復可能プロトコルを実装しており、Segments オブジェクトを、スプレッド構文や for...of ループなど、反復可能オブジェクトを期待するほとんどの構文で利用できるようにします。このメソッドは、それぞれの区間に関するデータを生成する区間イテレーターオブジェクトを返します。
試してみましょう
const segmenterFr = new Intl.Segmenter("fr", { granularity: "word" });
const string = "Que ma joie demeure";
const iterator = segmenterFr.segment(string)[Symbol.iterator]();
for (const segment of iterator) {
if (segment.segment.length > 4) {
console.log(segment.segment);
}
}
// 予想される結果: "demeure"
構文
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}
*/
仕様書
| Specification |
|---|
| ECMAScript® 2027 Internationalization API Specification # sec-%intlsegmentsprototype%-%symbol.iterator% |