English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Méthode filter() de l'array JavaScript

 Objet tableau JavaScript

 La méthode filter() crée un nouvel array contenant tous les éléments qui ont passé le test réalisé par la fonction de rappel fournie.

Attention : La méthode filter() ne modifie pas l'array original.

Syntaxe :

array.filter(callback, thisArg)
var age = [1, 30, 39, 29, 10, 13];
var val = age.filter(isAdult);
function isAdult(element) {
    return element >= 18;
}
Testez et voyez‹/›

Compatibilité du navigateur

Les nombres dans le tableau indiquent la première version de navigateur entièrement compatible avec la méthode filter() :

Méthode
filter()Est1.5EstEst9

Valeur des paramètres

ParamètresDescription
callback
Fonction à exécuter pour chaque élément de l'array.
Paramètres de la fonction :
  • element(Obligatoire)-Élément courant en cours de traitement dans l'array

  • index(Facultatif)-Index de l'élément courant en cours de traitement dans l'array

  • array(Facultatif)- Appelé sur l'arrayFiltre

thisArg(Facultatif) Valeur, utilisée lors de l'exécution de la fonction de rappel

Détails techniques

Valeur de retour :Un nouveau tableau d'éléments ayant réussi le test. Si aucun élément ne passe le test, une tableau vide est retourné
Version JavaScript :ECMAScript 5

Plus d'exemples

L'exemple suivant utilise la méthode filter() pour filtrer le contenu de l'array en fonction des conditions de recherche :

var fruits = ['apple', 'mango', 'banana', 'orange', 'grapes'];
/**
 * Filtre de sélection d'array basé sur les conditions de recherche (recherche)
 */
function filterItems(query) {
   return fruits.filter(function(el) {
         return el.indexOf(query) > -1;
   }
}
function myFunc(val) {
    document.getElementById("result").innerHTML = filterItems(val);
}
Testez et voyez‹/›

 Objet tableau JavaScript