String.prototype[@@iterator]()

O método [@@iterator]() retorna um novo objeto Iterator que itera sobre os pontos de código do valor da String, retornando cada ponto de código como um valor String.

Sintaxe

str[Symbol.iterator]

Valor de Retorno

Novo objeto Iterator.

Exemplos

Usando [@@iterator]()

var str = 'A\uD835\uDC68';

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

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

Usando [@@iterator]() com 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"

Especificações

Status Comment
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'String.prototype[@@iterator]()' in that specification.
Padrão Definição inicial.
ECMAScript (ECMA-262)
The definition of 'String.prototype[@@iterator]()' in that specification.
Padrão em tempo real

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também