Método some() do Array JavaScript

Definição e uso

some() O método verifica se qualquer elemento do array passa no teste (como função fornecida).

some() O método executa uma função para cada elemento existente no array:

  • Se encontrar o elemento do array que retorna verdadeiro, some() retorna verdadeiro (e não verifica os valores restantes)
  • Caso contrário, retorna false

Nota:some() Não executa a função para elementos do array sem valor.

Nota:some() Não altera o array original.

Exemplo

Exemplo 1

Verificar se há valores de 18 ou mais no array ages:

var ages = [3, 10, 18, 20];
function checkAdult(age) {
  return age >= 18;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.some(checkAdult);
}

Experimente você mesmo

Exemplo 2

Verificar se qualquer valor do array ages é igual ou maior que um número específico:

<p>Idade mínima: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Experimente</button>
<p>Idade acima de: <span id="demo"></span></p>
<script>
var ages = [4, 12, 16, 20];
function checkAdult(age) {
  return age >= document.getElementById("ageToCheck").value;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.some(checkAdult);
}
</script>

Experimente você mesmo

Sintaxe

array.some(function(currentValue, index, arr, thisValue)

valor do parâmetro

Parâmetro Descrição
function(currentValue, index, arr) Obrigatório. A função executada para cada elemento do array.

Parâmetros da função:

Parâmetro Descrição
currentValue Obrigatório. O valor do elemento atual.
index Opcional. O índice do array do elemento atual.
arr Opcional. O objeto do array ao qual o elemento atual pertence.
thisValue

Opcional. O valor a ser passado para a função para usar como seu valor "this".

Se este parâmetro estiver vazio, o valor "undefined" será passado como seu valor "this".

Detalhes técnicos

Valor retornado: Valor booleano. Se qualquer elemento do array passar pelo teste, retorna true, caso contrário, retorna false.
Versão do JavaScript: ECMAScript 3

Suporte do navegador

Os números na tabela indicam a primeira versão do navegador que suporta este método completamente.

Todos os navegadores suportam completamente some() Método:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Suporte 9.0 Suporte Suporte Suporte Suporte

Páginas relacionadas

Tutorial:Array do JavaScript

Tutorial:Const do Array do JavaScript

Tutorial:Métodos de Array do JavaScript

Tutorial:Ordenação de arrays do JavaScript

Tutorial:Iteração de Array do JavaScript