String.prototype[@@iterator]()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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]()

js
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

js
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

Specification
ECMAScript Language Specification
# sec-string.prototype-%symbol.iterator%

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também