Array.prototype.every()

Experimente

const isBelowThreshold = (currentValue) => currentValue < 40;

const array1 = [1, 30, 39, 29, 10, 13];

console.log(array1.every(isBelowThreshold));
// Expected output: true

Sintaxe

arr.every(callback[, thisArg])

Parmetros

callback

Funo que testa cada elemento, recebe trs parametros:

currentValue (obrigatrio)

O elemento atual sendo processado na array.

index (opcional)

O ndice do elemento atual sendo processado na array.

array (opcional)

O array de origem.

thisArg

Opcional. Valor a ser usado como this quando o callback executado.

Valor de retorno

true se a funo de callback retorna um valor truthy para cada um dos elementos do array; caso contrrio, false.

Descrio

O mtodo every executa a funo callback fornecida uma vez para cada elemento presente no array, at encontrar algum elemento em que a funo retorne um valor false (valor que se torna false quando convertido para boolean). Se esse elemento encontrado, o mtodo every imediatamente retorna false. Caso contrrio, se a funo callback retornar true para todos elementos, o mtodo retorna true. A funo callback chamada apenas para os elementos do array original que tiverem valores atribudos; os elementos que tiverem sido removidos ou os que nunca tiveram valores atribudos no sero considerados.

A funo callback chamada com trs argumentos: o valor do elemento corrente, o ndice do elemento corrente e o array original que est sendo percorrido.

Se o parmetro thisArg foi passado para o mtodo every, ele ser repassado para a funo callback no momento da chamada para ser utilizado como o this. Caso contrrio, o valor undefined ser repassado para uso como o this. O valor do this a ser repassado para o callback determinado de acordo com as regras usuais para determinar o this visto por uma funo.

O mtodo everyno modifica o array original.

A lista de elementos que sero processados pelo every montada antes da primeira chamada da funo callback. Se um elemento for acrescentado ao array original aps a chamada ao every , ele no ser visvel para o callback. Se os elementos existentes forem modificados, os valores que sero repassados sero os do momento em que o mtodo every chamar o callback. Elementos removidos no sero considerados.

every funciona como o qualificador "for all" em matemtica. Particularmente, para um vetor vazio, retornado true. ( verdade por vacuidade que todos os elementos do conjunto vazio satisfazem qualquer condio.)

Exemplos

Testando tamanho de todos os elementos do vetor

O exemplo a seguir testa se todos elementos no array so maiores que 10.

function isBigEnough(element, index, array) {
  return element >= 10;
}
[12, 5, 8, 130, 44].every(isBigEnough); // false
[12, 54, 18, 130, 44].every(isBigEnough); // true

Usando arrow functions

Arrow functions fornecem sintaxe mais curta para o mesmo teste.

[12, 5, 8, 130, 44].every((elem) => elem >= 10); // false
[12, 54, 18, 130, 44].every((elem) => elem >= 10); // true

Polyfill

every foi adicionado ao padro ECMA-262 na 5 edio; como tal, pode no estar presente em outras implementaes do padro. Voc pode contornar isso adicionando o seguinte cdigo no comeo dos seus scripts, permitindo o uso de every em implementaes que no o suportam nativamente. Esse algoritimo exatamente o mesmo especificado no ECMA-262, 5 edio, assumindo que Object e TypeError tem os seus valores originais e que callbackfn.call retorna o valor original de Function.prototype.call

if (!Array.prototype.every) {
  Array.prototype.every = function (callbackfn, thisArg) {
    "use strict";
    var T, k;

    if (this == null) {
      throw new TypeError("this is null or not defined");
    }

    // 1. Let O be the result of calling ToObject passing the this
    //    value as the argument.
    var O = Object(this);

    // 2. Let lenValue be the result of calling the Get internal method
    //    of O with the argument "length".
    // 3. Let len be ToUint32(lenValue).
    var len = O.length >>> 0;

    // 4. If IsCallable(callbackfn) is false, throw a TypeError exception.
    if (typeof callbackfn !== "function") {
      throw new TypeError();
    }

    // 5. If thisArg was supplied, let T be thisArg; else let T be undefined.
    if (arguments.length > 1) {
      T = thisArg;
    }

    // 6. Let k be 0.
    k = 0;

    // 7. Repeat, while k < len
    while (k < len) {
      var kValue;

      // a. Let Pk be ToString(k).
      //   This is implicit for LHS operands of the in operator
      // b. Let kPresent be the result of calling the HasProperty internal
      //    method of O with argument Pk.
      //   This step can be combined with c
      // c. If kPresent is true, then
      if (k in O) {
        // i. Let kValue be the result of calling the Get internal method
        //    of O with argument Pk.
        kValue = O[k];

        // ii. Let testResult be the result of calling the Call internal method
        //     of callbackfn with T as the this value and argument list
        //     containing kValue, k, and O.
        var testResult = callbackfn.call(T, kValue, k, O);

        // iii. If ToBoolean(testResult) is false, return false.
        if (!testResult) {
          return false;
        }
      }
      k++;
    }
    return true;
  };
}

Especificaes

Compatibilidade com navegadores

Veja tambm

• Array.prototype.forEach()
• Array.prototype.some()
• TypedArray.prototype.every()