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.
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 | 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 |
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.
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.