MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

String.prototype[@@iterator]()

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

string[Symbol.iterator]

Return value

A new Iterator object.

Examples

Using [@@iterator]()

var string = 'A\uD835\uDC68';

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

console.log(strIter.next().value); // "A"
console.log(strIter.next().value); // "\uD835\uDC68"

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

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

for (var v of string) {
  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.
Draft  

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic Support(Yes)?

17 — 27 (as iterator)

27 — 36 (as @@iterator)1

362

NoNoNo
FeatureAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic SupportNoNo?36NoNoNo

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

2. The @@iterator symbol is implemented.

See also

Document Tags and Contributors

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