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.
String.prototype[@@iterator]()
Try it
Syntax
str[Symbol.iterator]
Return value
A new iterator object.
Examples
Using [@@iterator]()
var str = 'A\uD835\uDC68'; var strIter = str[Symbol.iterator](); console.log(strIter.next().value); // "A" console.log(strIter.next().value); // "\uD835\uDC68"
Using [@@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"
Specifications
Browser compatibility
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | Deno | Node.js | |
@@iterator |
38
|
12
|
36
27-36
A placeholder property named
@@iterator is used.
17-27
A placeholder property named
iterator is used.
|
No
|
25
|
9
|
38
|
38
|
36
27-36
A placeholder property named
@@iterator is used.
17-27
A placeholder property named
iterator is used.
|
25
|
9
|
3.0
|
1.0
|
0.12.0
|
See also
© 2005–2022 MDN 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