JavaScript Array filter() 方法

定义和用法

filter() 方法创建数组，其中填充了所有通过测试的数组元素（作为函数提供）。

注释：filter() 不会对没有值的数组元素执行该函数。

注释：filter() 不会改变原始数组。

实例

例子 1

返回由 ages 数组中所有 18 岁或以上的值组成的数组：

var ages = [32, 33, 16, 40];

function checkAdult(age) {
  return age >= 18;
}

function myFunction() {
  document.getElementById("demo").innerHTML = ages.filter(checkAdult);
}

亲自试一试

例子 2

返回由 ages 数组中所有大于等于特定数字的值组成的数组：

<p>Minimum age: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Try it</button>

<p>All ages above 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>

亲自试一试

语法

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

参数值

参数 描述
function(currentValue, index, arr) 必需。为数组中的每个元素运行的函数。

函数参数：

参数 描述
currentValue 必需。当前元素的值。
index 可选。当前元素的数组索引。
arr 可选。当前元素所属的数组对象
thisValue

可选。要传递给函数以用作其 "this" 值的值。

如果此参数为空，则值 "undefined" 将作为其 "this" 值传递。

技术细节

返回值： 包含所有通过测试的数组元素的数组。如果没有元素通过测试，则返回一个空数组。
JavaScript 版本： ECMAScript 5

浏览器支持

所有浏览器都完全支持 filter() 方法：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
支持 9.0 支持 支持 支持 支持

相关页面

教程：JavaScript 数组

教程：JavaScript 数组 Const

教程：JavaScript 数组方法

教程：JavaScript 排序数组

教程：JavaScript 数组迭代