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

Método filter() do Array JavaScript

 Objeto Array do JavaScript

 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.

Sintaxe:

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‹/›

Compatibilidade do navegador

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

Valor do parâmetro

ParâmetroDescrição
callback
Função a ser executada para cada elemento do array
Parâmetros da função:
  • element(Obrigatório)-Elemento atual em processamento no array

  • index(Opcional)-Índice do elemento atual em processamento no array

  • array(Opcional)- Chamou o arrayFiltro

thisArg(Opcional) Valor, usado ao invocar a função de callback

Detalhes técnicos

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

Mais Exemplos

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‹/›

 Objeto Array do JavaScript