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.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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
Specification |
---|
ECMAScript (ECMA-262) The definition of 'String.prototype[@@iterator]()' in that specification. |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
@@iterator | Chrome Full support 38 | Edge Full support 12 | Firefox
Full support
36
| IE No support No | Opera Full support 25 | Safari No support No | WebView Android Full support 38 | Chrome Android Full support 38 | Firefox Android
Full support
36
| Opera Android Full support 25 | Safari iOS No support No | Samsung Internet Android Full support 3.0 | nodejs Full support 0.12 |
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.
- See implementation notes.
- Uses a non-standard name.
- Uses a non-standard name.