English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
O método filter() cria um novo array contendo todos os elementos que passaram pelo teste implementado pela função de callback fornecida.
Anotação: O método filter() não altera o array original.
array.filter(callback, thisArg)
var age = [1, 30, 39, 29, 10, 13]; var val = age.filter(isAdult); function isAdult(element) { return element >= 18; }Testar e Verificar‹/›
Os números na tabela especificam a primeira versão do navegador que suporta completamente o método filter():
Método | |||||
filter() | É | 1.5 | É | É | 9 |
Parâmetro | Descrição |
---|---|
callback | Função a ser executada para cada elemento do array Parâmetros da função:
|
thisArg | (Opcional) Valor, usado ao invocar a função de callback |
Retorno: | Um novo array com elementos que passaram no teste. Se nenhum elemento passar no teste, uma array vazia será retornada |
---|---|
Versão do JavaScript: | ECMAScript 5 |
O seguinte exemplo usa o método filter() para filtrar o conteúdo do array com base nas condições de pesquisa:
var fruits = ['apple', 'mango', 'banana', 'orange', 'grapes']; /** * Filtros de Array Baseados nas Condições de Pesquisa (Consulta) */ function filterItems(query) { return fruits.filter(function(el) { return el.indexOf(query) > -1; } } function myFunc(val) { document.getElementById("result").innerHTML = filterItems(val); }Testar e Verificar‹/›