JavaScript Array filter()

Définition et utilisation

filter() La méthode crée un array où sont remplis tous les éléments d'array passant le test (fournis en tant que fonction).

Remarque :filter() Ne s'applique pas à l'exécution de la fonction sur les éléments d'array sans valeur.

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

Exemple

Exemple 1

Retourne un tableau composé de toutes les valeurs comprises dans l'array ages qui sont de 18 ans ou plus :

var ages = [32, 33, 16, 40];
function checkAdult(age) {
  return age >= 18;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.filter(checkAdult);
}

Essayez-le vous-même

Exemple 2

Retourne un tableau composé de toutes les valeurs comprises dans l'array ages qui sont supérieures ou égales à un nombre spécifique :

<p>Âge minimum : <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Essayez</button>
<p>Toutes les âges au-dessus du minimum : <span id="demo"></span></p>
<script>
var ages = [32, 33, 12, 40];
function checkAdult(age) {
  return age >= document.getElementById("ageToCheck").value;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.filter(checkAdult);
}
</script>

Essayez-le vous-même

Syntaxe

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

valeur de paramètre

Paramètres Description
function(currentValue, index, arr) Obligatoire. La fonction exécutée sur 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 d'array courant
arr Optionnel. L'objet d'array auquel appartient l'élément courant
thisValue

Optionnel. La valeur à passer à la fonction en tant que valeur "this".

Si ce paramètre est vide, la valeur "undefined" est transmise comme sa valeur "this".

Détails techniques

Valeur de retour : Tableau contenant tous les éléments d'array passant le test. Si aucun élément ne passe le test, retourne un tableau vide.
Version JavaScript : ECMAScript 5

Support du navigateur

Tous les navigateurs le supportent complètement filter() Méthode :

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

Pages associées

Tutoriel :Tableaux JavaScript

Tutoriel :Const des tableaux JavaScript

Tutoriel :Méthodes des tableaux JavaScript

Tutoriel :Tri des tableaux JavaScript

Tutoriel :Itération des tableaux JavaScript