The [@@iterator]() method returns a new Iterator object that iterates over the code points of a String value, returning each code point as a String value.
str[Symbol.iterator]
A new Iterator object.
[@@iterator]()
var str = 'A\uD835\uDC68'; var strIter = str[Symbol.iterator](); console.log(strIter.next().value); // "A" console.log(strIter.next().value); // "\uD835\uDC68"
[@@iterator]() with for..of
var str = 'A\uD835\uDC68B\uD835\uDC69C\uD835\uDC6A';
for (var v of str) {
console.log(v);
}
// "A"
// "\uD835\uDC68"
// "B"
// "\uD835\uDC69"
// "C"
// "\uD835\uDC6A"
| Specification | Status | Comment |
|---|---|---|
| ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'String.prototype[@@iterator]()' in that specification. | Standard | Initial definition. |
| ECMAScript Latest Draft (ECMA-262) The definition of 'String.prototype[@@iterator]()' in that specification. | Living Standard |
| Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | Yes | Yes |
17 — 271 364 |
No | No | No |
| Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
| Basic support | No | No | ? | 36 | No | No | No |
1. Supported as iterator.
2. A placeholder property named @@iterator is used.
3. Supported as @@iterator.
4. The @@iterator symbol is implemented.
© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/@@iterator