O loopfor...of percorreobjetos iterativos (incluindoArray,Map,Set, o objetoarguments e assim por diante), chamando uma função personalizada com instruções a serem executadas para o valor de cada objeto distinto.

Sintaxe

for (variavel of iteravel) {  declaração}

variável

A cada iteração, um valor de uma propriedade diferente é atribuido àvariável.

iteravel

Objeto cujos atributos serão iterados.

Exemplos

Iterando sobre umArray

let iterable = [10, 20, 30];for (let value of iterable) {  console.log(value);}// 10// 20// 30

Ao invés delet, você pode usarconst se você não for modificar a variável dentro do bloco.

let iterable = [10, 20, 30];for (const value of iterable) {  console.log(value);}// 10// 20// 30

Iterando sobre umaString

let iterable = "boo";for (let value of iterable) {  console.log(value);}// "b"// "o"// "o"

Iterando sobre umaTypedArray

let iterable = new Uint8Array([0x00, 0xff]);for (let value of iterable) {  console.log(value);}// 0// 255

Iterando sobre umMap

let iterable = new Map([["a", 1], ["b", 2], ["c", 3]]);for (let entry of iterable) {  console.log(entry);}// [a, 1]// [b, 2]// [c, 3]for (let [key, value] of iterable) {  console.log(value);}// 1// 2// 3

Iterando sobre umSet

let iterable = new Set([1, 1, 2, 2, 3, 3]);for (let value of iterable) {  console.log(value);}// 1// 2// 3

Iterando sobre um objetoarguments

(function() {  for (let argument of arguments) {    console.log(argument);  }})(1,2,3);// 1// 2// 3

Iterando sobre uma coleção do DOM

Iterar sobre uma coleção do DOM comoNodeList: o seguinte exemplo adiciona uma classeread aos parágrafos que são descendentes diretos de uma tagarticle:

// Nota: Isso irá funcionar somente em plataformas que tem// suporte ao NodeList.prototype[Symbol.iterator]let articleParagraphs = document.querySelectorAll("article > p");for (let paragraph of articleParagraphs) {  paragraph.classList.add("read");}

Iterando sobre generators

Você pode também iterar sobregenerators:

function* fibonacci() { // uma função geradora (generator)  let [prev, curr] = [1, 1];  while (true) {    [prev, curr] = [curr, prev + curr];    yield curr;  }}for (let n of fibonacci()) {  console.log(n);  // Trunca a sequência em 1000  if (n >= 1000) {    break;  }}

Não reuse generators

Generators não devem ser re-usados, mesmo se o loopfor...of for terminado precocemente, por exemplo através da palavra-chavebreak. Enquanto em um loop ativo, o generator é fechado e tentar iterar novamente sobre ele não produz (yield) nenhum resultado adicional. O Firefox ainda não implementou este comportamento (o generator pode ser reutilizado, violando o padrão do ES2015 (13.7.5.13, step 5m), mas isso irá mudar uma vez que oErro do Firefox 1147371 for resolvido.

var gen = (function *(){  yield 1;  yield 2;  yield 3;})();for (let o of gen) {  console.log(o);  break;  // Closes iterator}// O generator não deve ser reutilizado, o código a seguir não// faz sentido!for (let o of gen) {  console.log(o); // Nunca será chamado.}

Iterando sobre outros objetos iteráveis

Você pode também iterar sobre um objeto que implementa explicitamente um protocoloiterável protocol:

var iterable = {  [Symbol.iterator]() {    return {      i: 0,      next() {        if (this.i < 3) {          return { value: this.i++, done: false };        }        return { value: undefined, done: true };      }    };  }};for (var value of iterable) {  console.log(value);}// 0// 1// 2

Diferença entrefor...of efor...in

O loopfor...in irá iterar sobre todas as propriedades enumeráveis de um objeto.

A sintaxe dofor...of é específica paracoleções, ao invés de todos os objetos. Ela irá iterar desta maneira sobre os elementos de qualquer coleção que tiver uma propriedade[Symbol.iterator].

O exemplo a seguir mostra a diferença entre um loopfor...of e um loopfor...in.

Object.prototype.objCustom = function () {};Array.prototype.arrCustom = function () {};let iterable = [3, 5, 7];iterable.foo = "hello";for (let i in iterable) {  console.log(i); // escreve 0, 1, 2, "foo", "arrCustom", "objCustom"}for (let i of iterable) {  console.log(i); // escreve 3, 5, 7}

Especificações

Compatibilidade com navegadores

Consulte também

• for each...in - uma declaração similar, mas que itera entre os valores dos atributos de um objeto, ao invés dos seus nomes (obsoleto).
• Array.prototype.forEach()