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.



Return value

A new Iterator object.


Using [@@iterator]()

var str = 'A\uD835\uDC68';

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

console.log(; // "A"
console.log(; // "\uD835\uDC68"

Using [@@iterator]() with for..of

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

for (var v of str) {
// "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.

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support Yes Yes


27 — 361 2

17 — 273 4

No No No
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support No No ?


27 — 361 2

17 — 273 4

No No No

1. A placeholder property named @@iterator is used.

2. Supported as @@iterator.

3. A placeholder property named iterator is used.

4. Supported as iterator.

See also

Document Tags and Contributors

Contributors to this page: wbamberg, zhuangyin, fscholz, kdex, eduardoboucas, Mingun, arai
Last updated by: wbamberg,