JavaScript Array 对象方法总结

文章摘自 《JavaScript高级程序设计(第3版)》 及 菜鸟教程

类似文章推荐: JavaScript String 对象方法总结

方法	描述	备注
isArray()	判断对象是否为数组	数组检测
toString()	把数组转换为字符串，并返回结果	数组转字符串
valueOf()	返回数组对象的原始值
join()	把数组的所有元素放入一个字符串	数组转字符串
push()	向数组的末尾添加一个或更多元素，并返回新的长度
pop()	删除数组的最后一个元素并返回删除的元素
unshift()	向数组的开头添加一个或更多元素，并返回新的长度
shift()	删除并返回数组的第一个元素
reverse()	反转数组的元素顺序
sort()	对数组的元素进行排序
concat()	连接两个或更多的数组，并返回结果
slice()	选取数组的的一部分，并返回一个新数组
splice()	从数组中添加或删除元素
ndexOf()	搜索数组中的元素，并返回它所在的位置
lastIndexOf()	返回一个指定的字符串值最后出现的位置，在一个字符串中的指定位置从后向前搜索
every()	检测数值元素的每个元素是否都符合条件
filter()	检测数值元素，并返回符合条件所有元素的数组
forEach()	数组每个元素都执行一次回调函数
map()	通过指定函数处理数组的每个元素，并返回处理后的数组
some()	检测数组元素中是否有元素符合指定条件
reduce()	将数组元素计算为一个值（从左到右）
reduceRight()	将数组元素计算为一个值（从右到左）
copyWithin()	从数组的指定位置拷贝元素到数组的另一个指定位置中
entries()	返回数组的可迭代对象
fill()	使用一个固定值来填充数组
find()	返回符合传入测试（函数）条件的数组元素
findIndex()	返回符合传入测试（函数）条件的数组元素索引
from()	通过给定的对象中创建一个数组
includes()	判断一个数组是否包含一个指定的值
keys()	返回数组的可迭代对象，包含原始数组的键(key)

一. 检测数组

isArray()

• 定义和用法
  isArray() 方法用于判断一个对象是否为数组
• 语法
  Array.isArray(obj)
  • 参数值
    • obj 必需，要判断的对象
  • 返回值
    • Boolean 如果对象是数组返回 true，否则返回 false

二. 转换方法

提示: 如果数组中的某一项的值是 null 或 undefined, 那么该值在 toString()、valueOf() 和 join() 方法返回的结果中以空字符串表示

toString()

• 定义和用法
  toString() 方法可把数组转换为字符串，并返回结果, 数组的所有值用逗号隔开
• 语法
  array.toString()
  • 返回值
    • String 数组的所有值用逗号隔开
• 注意
  数组中的元素之间用逗号分隔

valueOf()

• 定义和用法
  • valueOf() 方法返回 Array 对象的原始值
  • 该原始值由 Array 对象派生的所有对象继承
  • valueOf() 方法通常由 JavaScript 在后台自动调用，并不显式地出现在代码中
• 语法
  array.valueOf()
  • 返回值
    • Array valueOf() 返回数组值
• 注意
  valueOf() 方法不会改变原数组

join()

• 定义和用法
  • join() 方法用于把数组中的所有元素转换一个字符串
  • 元素是通过指定的分隔符进行分隔的
• 语法
  array.join(separator)
  • 参数值
    • separator 可选。指定要使用的分隔符。如果省略该参数，则使用逗号作为分隔符
  • 返回值
    • String 返回一个字符串。该字符串是通过把 arrayObject 的每个元素转换为字符串，然后把这些字符串连接起来，在两个元素之间插入 separator 字符串而生成的

三. 栈方法

push()

• 定义和用法
  push() 方法可向数组的末尾添加一个或多个元素，并返回新的长度
• 语法
  array.push(item1, item2, ..., itemX)
  • 参数值
    • item1, item2, ..., itemX 必需。要添加到数组的元素
  • 返回值
    • Number 数组新长度
• 提示
  在数组起始位置添加元素请使用 unshift() 方法
• 注意
  • 新元素将添加在数组的末尾
  • 此方法改变数组的长度

pop()

• 定义和用法
  pop() 方法用于删除数组的最后一个元素并返回删除的元素
• 语法
  array.pop()
  • 返回值
    • 任何类型 数组原来的最后一个元素的值（移除的元素）
    • 数组元素可以是一个字符串，数字，数组，布尔，或者其他对象类型
• 提示
  移除数组第一个元素，请使用 shift() 方法
• 注意
  此方法改变数组的长度

四. 队列方法

unshift()

• 定义和用法
  unshift() 方法可向数组的开头添加一个或更多元素，并返回新的长度
• 语法
  array.unshift(item1, item2, ..., itemX)
  • 参数值
    • item1, item2, ..., itemX 可选。向数组起始位置添加一个或者多个元素
  • 返回值
    • Number 数组新长度
• 提示
  将新项添加到数组末尾，请使用 push() 方法
• 注意
  该方法将改变数组的数目

shift()

• 定义和用法
  shift() 方法用于把数组的第一个元素从其中删除，并返回第一个元素的值
• 语法
  array.shift()
  • 返回值
    • 任何类型 数组原来的第一个元素的值（移除的元素）
    • 数组元素可以是一个字符串，数字，数组，布尔，或者其他对象类型
• 提示
  移除数组末尾的元素可以使用 pop() 方法
• 注意
  此方法改变数组的长度

五. 重排序方法

reverse()

• 定义和用法
  reverse() 方法用于颠倒数组中元素的顺序
• 语法
  array.reverse()
  • 返回值
    • Array 颠倒顺序后的数组

sort()

• 定义和用法
  • sort() 方法用于对数组的元素进行排序
  • 排序顺序可以是字母或数字，并按升序或降序
  • 默认排序顺序为按字母升序
• 语法
  array.sort(sortfunction)
  • 参数值
    • sortfunction 可选。规定排序顺序。必须是函数
  • 返回值
    • Array 排序之后的数组
    • 注: 数组在原数组上进行排序，不生成副本
• 提示
  这种方法会改变原始数组
• 注意
  • 当数字是按字母顺序排列时"40"将排在"5"前面
  • 使用数字排序，你必须通过一个函数作为参数来调用
  • 函数指定数字是按照升序还是降序排列

六. 操作方法

concat()

• 定义和用法
  • concat() 方法用于连接两个或多个数组
  • 该方法不会改变现有的数组，而仅仅会返回被连接数组的一个副本
• 语法
  array1.concat(array2, array3, ..., arrayX)
  • 参数值
    • array2, array3, ..., arrayX 必需。该参数可以是具体的值，也可以是数组对象。可以是任意多个
  • 返回值
    • Array 返回一个新的数组。该数组是通过把所有 arrayX 参数添加到 arrayObject 中生成的。如果要进行 concat() 操作的参数是数组，那么添加的是数组中的元素，而不是数组

slice()

• 定义和用法
  • slice() 方法可从已有的数组中返回选定的元素
  • slice()方法可提取字符串的某个部分，并以新的字符串返回被提取的部分
• 语法
  array.slice(start, end)
  • 参数值
    • start 可选。规定从何处开始选取。如果是负数，那么它规定从数组尾部开始算起的位置。也就是说，-1 指最后一个元素，-2 指倒数第二个元素，以此类推
    • end 可选。规定从何处结束选取。该参数是数组片断结束处的数组下标。如果没有指定该参数，那么切分的数组包含从 start 到数组结束的所有元素。如果这个参数是负数，那么它规定的是从数组尾部开始算起的元素
  • 返回值
    • Array 返回一个新的数组，包含从 start 到 end （不包括该元素）的 arrayObject 中的元素
• 注意
  slice() 方法不会改变原始数组

splice()

• 定义和用法
  splice() 方法用于添加或删除数组中的元素
• 语法
  array.splice(index, howmany, item1, ..., itemX)
  • 参数值
    • index 必需。规定从何处添加/删除元素。该参数是开始插入和（或）删除的数组元素的下标，必须是数字
    • howmany 必需。规定应该删除多少元素。必须是数字，但可以是 "0"。如果未规定此参数，则删除从 index 开始到原数组结尾的所有元素
    • item1, ..., itemX 可选。要添加到数组的新元素
  • 返回值
    • Array 如果从 arrayObject 中删除了元素，则返回的是含有被删除的元素的数组
• 注意
  这种方法会改变原始数组

七. 位置方法

indexOf()

• 定义和用法
  • indexOf() 方法可返回数组中某个指定的元素位置
  • 该方法将从头到尾地检索数组，看它是否含有对应的元素。开始检索的位置在数组 start 处或数组的开头（没有指定 start 参数时）。如果找到一个 item，则返回 item 的第一次出现的位置。开始位置的索引为 0
  • 如果在数组中没找到指定元素则返回 -1
• 语法
  array.indexOf(item,start)
  • 参数值
    • item 必须。查找的元素
    • start 可选的整数参数。规定在字符串中开始检索的位置。它的合法取值是 0 到 stringObject.length - 1。如省略该参数，则将从字符串的首字符开始检索
  • 返回值
    • Number 元素在数组中的位置,如果没与搜索到则返回 -1
• 提示
  如果你想查找字符串最后出现的位置，请使用 lastIndexOf() 方法

lastIndexOf()

• 定义和用法

  • lastIndexOf() 方法可返回一个指定的元素在数组中最后出现的位置，在一个数组中的指定位置从后向前搜索
  • 如果要检索的元素没有出现，则该方法返回 -1
  • 该方法将从尾到头地检索数组中指定元素 item。开始检索的位置在数组的 start 处或数组的结尾（没有指定 start 参数时）。如果找到一个 item，则返回 item 从尾向前检索第一个次出现在数组的位置。数组的索引开始位置是从 0 开始的
  • 如果在数组中没找到指定元素则返回 -1

• 语法
  array.lastIndexOf(item,start)

  • 参数值
    • item 必需。规定需检索的字符串值
    • start 可选的整数参数。规定在字符串中开始检索的位置。它的合法取值是 0 到 stringObject.length - 1。如省略该参数，则将从字符串的最后一个字符处开始检索
  • 返回值
    • Number 如果在 stringObject 中的 fromindex 位置之前存在 searchvalue，则返回的是出现的最后一个 searchvalue 的位置

• 提示
  如果你想查找数组首次出现的位置，请使用 indexOf() 方法

八. 迭代方法

every()

• 定义和用法
  • every() 方法用于检测数组所有元素是否都符合指定条件（通过函数提供）
  • every() 方法使用指定函数检测数组中的所有元素：
    • 如果数组中检测到有一个元素不满足，则整个表达式返回 false ，且剩余的元素不会再进行检测
    • 如果所有元素都满足条件，则返回 true
• 语法
  array.every(function(currentValue,index,arr), thisValue)
  • 参数值
    • function(currentValue, index,arr) 必须。函数，数组中的每个元素都会执行这个函数
      • currentValue 必须。当前元素的值
      • index 可选。当前元素的索引值
      • arr 可选。当前元素属于的数组对象
    • thisValue 可选。对象作为该执行回调时使用，传递给函数，用作 "this" 的值。
      如果省略了 thisValue ，"this" 的值为 "undefined"
  • 返回值
    • Boolean 布尔值。如果所有元素都通过检测返回 true，否则返回 false
• 注意
  • every() 不会对空数组进行检测
  • every() 不会改变原始数组

filter()

• 定义和用法
  filter() 方法创建一个新的数组，新数组中的元素是通过检查指定数组中符合条件的所有元素
• 语法
  array.filter(function(currentValue,index,arr), thisValue)
  • 参数值
    • function(currentValue, index,arr) 必须。函数，数组中的每个元素都会执行这个函数
      • currentValue 必须。当前元素的值
      • index 可选。当前元素的索引值
      • arr 可选。当前元素属于的数组对象
    • thisValue 可选。对象作为该执行回调时使用，传递给函数，用作 "this" 的值。
      如果省略了 thisValue ，"this" 的值为 "undefined"
  • 返回值
    • Array 数组，包含了符合条件的所有元素。如果没有符合条件的元素则返回空数组
• 注意
  • filter() 不会对空数组进行检测
  • filter() 不会改变原始数组

forEach()

• 定义和用法
  forEach() 方法用于调用数组的每个元素，并将元素传递给回调函数
• 语法
  array.forEach(function(currentValue, index, arr), thisValue)
  • 参数值
    • function(currentValue, index, arr) 必需。 数组中每个元素需要调用的函数
      • currentValue 必需。当前元素
      • index 可选。当前元素的索引值
      • arr 可选。当前元素所属的数组对象
    • thisValue 可选。传递给函数的值一般用 "this" 值。
      如果这个参数为空， "undefined" 会传递给 "this" 值
  • 返回值
    • undefined
• 注意
  forEach() 对于空数组是不会执行回调函数的

map()

• 定义和用法
  • map() 方法返回一个新数组，数组中的元素为原始数组元素调用函数处理后的值
  • map() 方法按照原始数组元素顺序依次处理元素
• 语法
  array.map(function(currentValue,index,arr), thisValue)
  • 参数值
    • function(currentValue, index,arr) 必须。函数，数组中的每个元素都会执行这个函数
      • currentValue 必须。当前元素的值
      • index 可选。当前元素的索引值
      • arr 可选。当前元素属于的数组对象
    • thisValue 可选。对象作为该执行回调时使用，传递给函数，用作 "this" 的值。
      如果省略了 thisValue，或者传入 null、undefined，那么回调函数的 this 为全局对象
  • 返回值
    • Array 返回一个新数组，数组中的元素为原始数组元素调用函数处理后的值
• 注意
  • map() 不会对空数组进行检测
  • map() 不会改变原始数组

some()

• 定义和用法
  • some() 方法用于检测数组中的元素是否满足指定条件（函数提供）
  • some() 方法会依次执行数组的每个元素：
    • 如果有一个元素满足条件，则表达式返回true , 剩余的元素不会再执行检测
    • 如果没有满足条件的元素，则返回false
• 语法
  array.some(function(currentValue,index,arr),thisValue)
  • 参数值
    • function(currentValue, index,arr) 必须。函数，数组中的每个元素都会执行这个函数
      • currentValue 必须。当前元素的值
      • index 可选。当前元素的索引值
      • arr 可选。当前元素属于的数组对象
    • thisValue 可选。对象作为该执行回调时使用，传递给函数，用作 "this" 的值。
      如果省略了 thisValue ，"this" 的值为 "undefined"
  • 返回值
    • Boolean 布尔值。如果数组中有元素满足条件返回 true，否则返回 false
• 注意
  • some() 不会对空数组进行检测
  • some() 不会改变原始数组

九. 归并方法

reduce()

• 定义和用法
  • reduce() 方法接收一个函数作为累加器，数组中的每个值（从左到右）开始缩减，最终计算为一个值
  • reduce() 可以作为一个高阶函数，用于函数的 compose
• 语法
  array.reduce(function(total, currentValue, currentIndex, arr), initialValue)
  • 参数值
    • function(total,currentValue, index,arr) 必需。用于执行每个数组元素的函数
      • total 必需。初始值, 或者计算结束后的返回值
      • currentValue 必需。当前元素
      • currentIndex 可选。当前元素的索引
      • arr 可选。当前元素所属的数组对象
    • initialValue 可选。传递给函数的初始值
  • 返回值
    • Number 返回计算结果
• 注意
  reduce() 对于空数组是不会执行回调函数的

reduceRight()

• 定义和用法
  reduceRight() 方法的功能和 reduce() 功能是一样的，不同的是 reduceRight() 从数组的末尾向前将数组中的数组项做累加
• 语法
  array.reduceRight(function(total, currentValue, currentIndex, arr), initialValue)
  • 参数值
    • function(total,currentValue, index,arr) 必需。用于执行每个数组元素的函数
      • total 必需。初始值, 或者计算结束后的返回值
      • currentValue 必需。当前元素
      • currentIndex 可选。当前元素的索引
      • arr 可选。当前元素所属的数组对象
    • initialValue 可选。传递给函数的初始值
  • 返回值
    • Number 返回计算结果
• 注意
  reduceRight() 对于空数组是不会执行回调函数的