String.prototype[@@iterator]()

この翻訳は不完全です。英語から この記事を翻訳 してください。

これは Harmony(ECMAScript 6) 提案の一部であり、実験段階の技術です。
この技術の仕様は安定していません。ブラウザ互換性の一覧表を確認してください。またこれらの構文や動作は、仕様変更などにより、新しいバージョンのブラウザでは変更される可能性があるという点に注意してください。

概要

文字列値のコードポイントを反復処理し新しいIteratorオブジェクトを返します。文字列値として各コードポイントを返します。

構文

string[Symbol.iterator]

例: [@@iterator]()を使う

var string = 'A\uD835\uDC68';

var strIter = string[Symbol.iterator]();

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

例: for..ofとともに[@@iterator]()を使う

var string = 'A\uD835\uDC68B\uD835\uDC69C\uD835\uDC6A';

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

仕様

仕様 状況 コメント
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'String.prototype[@@iterator]()' in that specification.
Standard Initial definition.

ブラウザ実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート (有) 17 (17) (.iterator)
27 (27) (["@@iterator"])
36 (36) ([Symbol.iterator])
未サポート 未サポート 未サポート
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート 未サポート (有) 17.0 (17) (.iterator)
27.0 (27) (["@@iterator"])
36.0 (36) ([Symbol.iterator])
未サポート 未サポート 未サポート

Gecko固有のメモ

  • Gecko 17 (Firefox 17 / Thunderbird 17 / SeaMonkey 2.14)からGecko 26 (Firefox 26 / Thunderbird 26 / SeaMonkey 2.23 / Firefox OS 1.2)までiterator プロパティが使われていました(バグ 907077)。Gecko 27 (Firefox 27 / Thunderbird 27 / SeaMonkey 2.24)からGecko 35 (Firefox 35 / Thunderbird 35 / SeaMonkey 2.32)まで"@@iterator" プレースホルダが@@iterator symbol のかわりに使われていました(バグ 918828)。

ドキュメントのタグと貢献者

 このページの貢献者: shide55
 最終更新者: shide55,