Méthode some() de tableau JavaScript

Définition et utilisation

some() La méthode vérifie si tout élément de l'array passe le test (fourni en tant que fonction).

some() La méthode exécute une fois la fonction pour chaque élément existant de l'array :

  • Si l'élément de l'array qui renvoie la valeur vérité est trouvé, some() renvoie la valeur vérité (et ne vérifie pas les valeurs restantes)
  • Sinon retourne false

Remarque :some() Ne pas exécuter la fonction pour les éléments d'array sans valeur.

Remarque :some() Ne change pas l'array original.

Exemple

Exemple 1

Vérifiez si l'array ages contient une valeur de 18 ou plus :

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

Essayez-le vous-même

Exemple 2

Vérifiez si une valeur quelconque de l'array ages est égale ou supérieure à un nombre spécifique :

<p>Minimum age: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Try it</button>
<p>Any ages above: <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>

Essayez-le vous-même

Syntaxe

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

valeur de paramètre

Paramètres Description
function(currentValue, index, arr) Obligatoire. La fonction à exécuter pour chaque élément de l'array.

Paramètres de la fonction :

Paramètres Description
currentValue Obligatoire. La valeur de l'élément courant.
index Optionnel. L'index de l'élément courant dans l'array.
arr Optionnel. L'objet d'array auquel appartient l'élément courant.
thisValue

Optionnel. La valeur à passer à la fonction pour utiliser comme valeur "this".

Si ce paramètre est vide, la valeur "undefined" est passée comme valeur "this".

Détails techniques

Valeur de retour : Valeur booléenne. Si tout élément de l'array passe le test, retourne true, sinon retourne false.
Version JavaScript : ECMAScript 3

Prise en charge du navigateur

Les numéros dans le tableau indiquent la version du premier navigateur prenant en charge cette méthode.

Tous les navigateurs prennent en charge pleinement cette méthode. some() Méthode :

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Support 9.0 Support Support Support Support

Pages connexes

Tutoriel :Array JavaScript

Tutoriel :Const d'array JavaScript

Tutoriel :Méthodes d'array JavaScript

Tutoriel :Tri d'array JavaScript

Tutoriel :Itération de tableau JavaScript