数组方法速查表

144 阅读12分钟

数组属性

属性描述
constructor返回创建数组对象的原型函数。
length设置或返回数组元素的个数。
prototype允许你向数组对象添加属性或方法。

Array 对象方法

方法描述
concat()连接两个或更多的数组,并返回结果。该方法不会改变现有的数组,而仅仅会返回被连接数组的一个副本。
copyWithin()从数组的指定位置拷贝元素到数组的另一个指定位置中。会影响所操作数组
entries()
every()检测数值元素的每个元素是否都符合条件。返回值:布尔值。如果所有元素都通过检测返回 true,否则返回 false。
fill()使用一个固定值来填充数组。会影响所操作数组
filter()检测数值元素,并返回符合条件所有元素的新数组。
find()数组元素。如果没有符合条件的元素返回 undefined
findIndex()数组元素索引。如果没有符合条件的元素返回 -1
forEach()数组每个元素都执行一次回调函数。
from()通过给定的对象中创建一个数组。
includes()判断一个数组是否包含一个指定的值。
indexOf()搜索数组中的元素,并返回它所在的位置。
isArray()判断对象是否为数组。如果对象是数组返回 true,否则返回 false。
join()把数组的所有元素放入一个字符串。
keys()返回数组的可迭代对象,包含原始数组的键(key)
lastIndexOf()搜索数组中的元素,并返回它最后出现的位置。
map()通过指定函数处理数组的每个元素,并返回处理后的数组。
pop()删除数组的最后一个元素并返回删除的元素。此方法改变数组的长度
push()向数组的末尾添加一个或更多元素,并返回新的长度。此方法改变数组的长度
reduce()将数组元素计算为一个值(从左到右)。
reduceRight()将数组元素计算为一个值(从右到左)。
reverse()反转数组的元素顺序。改变原数组,不会生成副本
shift()删除并返回数组的第一个元素。此方法改变数组的长度
slice()选取数组的一部分,并返回一个新数组。
some()检测数组元素中是否有元素符合指定条件。
sort()对数组的元素进行排序。
splice()从数组中添加或删除元素。
toString()把数组转换为字符串,并返回结果。
unshift()向数组的开头添加一个或更多元素,并返回新的长度。
valueOf()返回数组对象的原始值。

concat

语法

array1.concat(array2,array3,...,arrayX)

参数
参数描述
array2, array3, ..., arrayX必需。该参数可以是具体的值,也可以是数组对象。可以是任意多个。

copyWithin

语法

array.copyWithin(target, start, end)

参数

参数描述
target必需。复制到指定目标索引位置。
start可选。元素复制的起始位置。
end可选。停止复制的索引位置 (默认为 array.length)。如果为负值,表示倒数。

every

语法

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

参数说明
参数描述
function(currentValue, index,arr)必须。函数,数组中的每个元素都会执行这个函数 函数参数: currentValue必须。当前元素的值 index可选。当前元素的索引值 arr可选。当前元素属于的数组对象
thisValue可选。对象作为该执行回调时使用,传递给函数,用作 "this" 的值。 如果省略了 thisValue ,"this" 的值为 "undefined"

fill

语法

array.fill(value, start, end)

参数

参数描述
value必需。填充的值。
start可选。开始填充位置。
end可选。停止填充位置 (默认为 array.length)

tip

// 返回一个长度为m,每项值为n的数组
function repeatArr(m, n) {
  const arr = new Array(m)
  return arr.fill(n, 0)
}

filter

语法

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

参数说明
参数描述
function(currentValue, index,arr)必须。函数,数组中的每个元素都会执行这个函数 currentValue必须,当前元素的值。index可选,当前元素的索引值。arr可选,当前元素属于的数组对象
thisValue可选。对象作为该执行回调时使用,传递给函数,用作 "this" 的值。 如果省略了 thisValue ,"this" 的值为 "undefined"

find

语法

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

参数

参数描述
function(currentValue, index,arr)必需。数组每个元素需要执行的函数。 currentValue*必需,当前元素.index可选,当前元素的索引值。arr可选,当前元素所属的数组对象。
thisValue可选。 传递给函数的值一般用 "this" 值。 如果这个参数为空, "undefined" 会传递给 "this" 值

findIndex

语法

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

参数

参数描述
function(currentValue, index,arr)必须。数组每个元素需要执行的函数。 currentValue*必需,当前元素。index可选,当前元素的索引。arr可选,当前元素所属的数组对象。
thisValue可选。 传递给函数的值一般用 "this" 值。 如果这个参数为空, "undefined" 会传递给 "this" 值

forEach

语法

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

参数

参数描述
function(currentValue, index, arr)必需。 数组中每个元素需要调用的函数。 currentValue*必需,当前元素。index可选,当前元素的索引值。arr可选,当前元素所属的数组对象。
thisValue可选。传递给函数的值一般用 "this" 值。 如果这个参数为空, "undefined" 会传递给 "this" 值

from

from() 方法用于通过拥有 length 属性的对象或可迭代的对象来返回一个数组。

如果对象是数组返回 true,否则返回 false。

语法

Array.from(object, mapFunction, thisValue)

参数

参数描述
object必需,要转换为数组的对象。
mapFunction可选,数组中每个元素要调用的函数。
thisValue可选,映射函数(mapFunction)中的 this 对象。

includes

includes() 方法用来判断一个数组是否包含一个指定的值,如果是返回 true,否则false。

语法

arr.includes(searchElement)
arr.includes(searchElement, fromIndex)

参数说明

参数描述
searchElement必须。需要查找的元素值。
fromIndex可选。从该索引处开始查找 searchElement。如果为负值,则按升序从 array.length + fromIndex 的索引开始搜索。默认为 0。

indexOf

indexOf() 方法可返回数组中某个指定的元素位置。

该方法将从头到尾地检索数组,看它是否含有对应的元素。开始检索的位置在数组 start 处或数组的开头(没有指定 start 参数时)。如果找到一个 item,则返回 item 的第一次出现的位置。开始位置的索引为 0。

如果在数组中没找到指定元素则返回 -1。

语法

array.indexOf(item,start)

参数值

参数描述
item必须。查找的元素。
start可选的整数参数。规定在数组中开始检索的位置。它的合法取值是 0 到 stringObject.length - 1。如省略该参数,则将从字符串的首字符开始检索。

join

join() 方法用于把数组中的所有元素转换一个字符串。

元素是通过指定的分隔符进行分隔的。

语法

array.join(separator)

参数值

参数描述
separator可选。指定要使用的分隔符。如果省略该参数,则使用逗号作为分隔符。

返回值

类型描述
String返回一个字符串。该字符串是通过把 arrayObject 的每个元素转换为字符串,然后把这些字符串连接起来,在两个元素之间插入 separator 字符串而生成的。

lastIndexOf

astIndexOf() 方法可返回一个指定的元素在数组中最后出现的位置,从该字符串的后面向前查找。

如果要检索的元素没有出现,则该方法返回 -1。

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

如果在数组中没找到指定元素则返回 -1。

语法

array.lastIndexOf(item,start)

参数 Values

参数描述
item必需。规定需检索的字符串值。
start可选的整数参数。规定在字符串中开始检索的位置。它的合法取值是 0 到 stringObject.length - 1。如省略该参数,则将从字符串的最后一个字符处开始检索。

返回值

Type描述
Number如果在 stringObject 中的 fromindex 位置之前存在 searchvalue,则返回的是出现的最后一个 searchvalue 的位置。

map

map() 方法返回一个新数组,数组中的元素为原始数组元素调用函数处理后的值。

map() 方法按照原始数组元素顺序依次处理元素。

语法

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

参数说明
参数描述
function(currentValue, index,arr)必须。函数,数组中的每个元素都会执行这个函数。currentValue*必须,当前元素的值。index可选,当前元素的索引值。arr可选,当前元素属于的数组对象。
thisValue可选。对象作为该执行回调时使用,传递给函数,用作 "this" 的值。 如果省略了 thisValue,或者传入 null、undefined,那么回调函数的 this 为全局对象。

reduce

reduce() 方法接收一个函数作为累加器,数组中的每个值(从左到右)开始缩减,最终计算为一个值。

reduce() 可以作为一个高阶函数,用于函数的 compose。

语法

array.reduce(function(total, currentValue, currentIndex, arr), initialValue)

参数

参数描述
function(total,currentValue, index,arr)必需。用于执行每个数组元素的函数。 total*必需,初始值, 或者计算结束后的返回值。currentValue必需,当前元素。currentIndex可选,当前元素的索引。arr可选,当前元素所属的数组对象。
initialValue可选。传递给函数的初始值

reduceRight

reduceRight() 方法的功能和 reduce() 从数组的末尾向前将数组中的数组项做累加。

语法

array.reduceRight(function(total, currentValue, currentIndex, arr), initialValue)

参数

参数描述
function(total,currentValue, index,arr)必需。用于执行每个数组元素的函数。 total*必需,初始值, 或者计算结束后的返回值。currentValue必需,当前元素。currentIndex可选,当前元素的索引。arr可选,当前元素所属的数组对象。
initialValue可选。传递给函数的初始值

slice

slice() 方法可从已有的数组中返回选定的元素。

slice()方法可提取字符串的某个部分,并以新的字符串返回被提取的部分。

注意: slice() 方法不会改变原始数组。

语法

array.slice(start, end)

参数 Values

参数描述
start可选。规定从何处开始选取。如果是负数,那么它规定从数组尾部开始算起的位置。也就是说,-1 指最后一个元素,-2 指倒数第二个元素,以此类推。
end可选。规定从何处结束选取。该参数是数组片断结束处的数组下标。如果没有指定该参数,那么切分的数组包含从 start 到数组结束的所有元素。如果这个参数是负数,那么它规定的是从数组尾部开始算起的元素。

返回值

Type描述
Array返回一个新的数组,包含从 start 到 end (不包括该元素)的 arrayObject 中的元素。

some

some() 方法用于检测数组中的元素是否满足指定条件(函数提供)。

some() 方法会依次执行数组的每个元素:

  • 如果有一个元素满足条件,则表达式返回true , 剩余的元素不会再执行检测。
  • 如果没有满足条件的元素,则返回false。

注意: some() 不会对空数组进行检测。** some() 不会改变原始数组。

语法

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

参数说明
参数描述
function(currentValue, index,arr)必须。函数,数组中的每个元素都会执行这个函数。 currentValue*必须,当前元素的值。index可选,当前元素的索引值。arr可选,当前元素属于的数组对象
thisValue可选。对象作为该执行回调时使用,传递给函数,用作 "this" 的值。 如果省略了 thisValue ,"this" 的值为 "undefined"

sort

sort() 方法用于对数组的元素进行排序。

排序顺序可以是字母或数字,并按升序或降序。

默认排序顺序为按字母升序。

**注意:**当数字是按字母顺序排列时"40"将排在"5"前面。

使用数字排序,你必须通过一个函数作为参数来调用。

函数指定数字是按照升序还是降序排列。

注意: 这种方法会改变原始数组!。

参数 Values

参数描述
sortfunction可选。规定排序顺序。必须是函数。

返回值

Type描述
Array对数组的引用。请注意,数组在原数组上进行排序,不生成副本。

splice

splice() 方法用于添加或删除数组中的元素。

**注意:**这种方法会改变原始数组

语法

array.splice(index,howmany,item1,.....,itemX)

参数 Values

参数描述
index必需。规定从何处添加/删除元素。 该参数是开始插入和(或)删除的数组元素的下标,必须是数字。
howmany可选。规定应该删除多少元素。必须是数字,但可以是 "0"。 如果未规定此参数,则删除从 index 开始到原数组结尾的所有元素。
item1, ..., itemX可选。要添加到数组的新元素

返回值

Type描述
Array如果从 arrayObject 中删除了元素,则返回的是含有被删除的元素的数组。

unshift

unshift() 方法可向数组的开头添加一个或更多元素,并返回新的长度。

注意: 该方法将改变数组的数目。

语法

array.unshift(item1,item2, ..., itemX)

参数 Values

参数描述
item1,item2, ..., itemX可选。向数组起始位置添加一个或者多个元素。