常用API速查(数组篇)

(一)会改变原数组

1.pop()

作用:删除数组的最后一个元素

返回值:返回删除的元素

语法:

array.pop()

2.push()

作用:向数组的末尾添加一个或多个元素

返回值:返回新的长度

语法:

array.push(item1, item2, ..., itemX)
item1, item2, ..., itemX	必需。要添加到数组的元素。

3.shift()

作用:把数组的第一个元素从其中删除

返回值:返回第一个元素的值

语法:

array.shift()
任何类型（*）	数组原来的第一个元素的值（移除的元素）。
*：数组元素可以是一个字符串，数字，数组，布尔，或者其他对象类型。

4.unshift()

作用:向数组的开头添加一个或更多元素

返回值:返回新的长度

语法:

array.unshift(item1,item2, ..., itemX)
item1,item2, ..., itemX	可选。向数组起始位置添加一个或者多个元素。

5.reverse()

作用:颠倒数组中元素的顺序

返回值:颠倒顺序后的数组

语法:

array.reverse()

6.sort()

作用:

对数组的元素进行排序

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

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

返回值:排序后的数组

语法:

array.sort(function(a,b){return a-b});

7.splice()

作用:用于添加或删除数组中的元素

返回值:

如果删除一个元素，则返回一个元素的数组。 如果未删除任何元素，则返回空数组

语法:

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

(二)不会改变原数组及其他

1.concat()

作用:连接两个或多个数组

返回值:

返回一个新的数组。该数组是通过把所有 arrayX 参数添加到 arrayObject 中生成的。如果要进行 concat() 操作的参数是数组，那么添加的是数组中的元素，而不是数组。

语法:

array1.concat(array2,array3,...,arrayX)
array2, array3, ..., arrayX	必需。该参数可以是具体的值，
也可以是数组对象。可以是任意多个。

2.every()

作用:检测数组所有元素是否都符合指定条件（通过函数提供）

返回值:布尔值。如果所有元素都通过检测返回 true，否则返回 false。

语法:

array.every(function(currentValue,index,arr), thisValue)
currentValue	必须。当前元素的值
index	可选。当前元素的索引值
arr	可选。当前元素属于的数组对象
thisValue	可选。对象作为该执行回调时使用，传递给函数，用作 "this" 的值。
如果省略了 thisValue ，"this" 的值为 "undefined"

3.filter()

作用:创建一个新的数组，新数组中的元素是通过检查指定数组中符合条件的所有元素

返回值:返回数组，包含了符合条件的所有元素。如果没有符合条件的元素则返回空数组

语法:

array.filter(function(currentValue,index,arr), thisValue)
currentValue	必须。当前元素的值
index	可选。当前元素的索引值
arr	可选。当前元素属于的数组对象
thisValue	可选。对象作为该执行回调时使用，传递给函数，用作 "this" 的值。
如果省略了 thisValue ，"this" 的值为 "undefined"

4.find()

作用:测试满足条件的元素

返回值:返回符合测试条件的第一个数组元素值，如果没有符合条件的则返回 undefined

语法:

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

5.findIndex()

作用:测试满足条件的元素的位置

返回值:返回符合测试条件的第一个数组元素索引，如果没有符合条件的则返回 -1

语法:

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

6.forEach()

作用:用于调用数组的每个元素，并将元素传递给回调函数。

返回值:undefined

语法:

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

7.from()

作用:用于通过拥有 length 属性的对象或可迭代的对象来返回一个数组

返回值:数组对象

语法:

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

8.includes()

作用:用来判断一个数组是否包含一个指定的值

返回值:布尔值。如果找到指定值返回 true，否则返回 false

语法:

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

9.indexOf()

作用:查找指定元素的位置

返回值:元素在数组中的位置，如果没有搜索到则返回 -1

语法:

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

10.isArray()

作用:用于判断一个对象是否为数组

返回值:布尔值，如果对象是数组返回 true，否则返回 false

语法:

Array.isArray(obj)
obj	必需，要判断的对象

11.join()

作用:用于把数组中的所有元素转换一个字符串,元素是通过指定的分隔符进行分隔的

返回值:

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

语法:

array.join(separator)
separator	可选。指定要使用的分隔符。如果省略该参数，则使用逗号作为分隔符。

12.map()

作用:按照原始数组元素顺序依次处理元素

返回值:返回一个新数组，数组中的元素为原始数组元素调用函数处理后的值

语法:

array.map(function(currentValue,index,arr), thisValue)
currentValue	必须。当前元素的值
index	可选。当前元素的索引值
arr	可选。当前元素属于的数组对象
thisValue	可选。对象作为该执行回调时使用，传递给函数，用作 "this" 的值。
如果省略了 thisValue，或者传入 null、undefined，那么回调函数的 this 为全局对象。

13.reduce()

作用:接收一个函数作为累加器，数组中的每个值（从左到右）开始缩减，最终计算为一个值

返回值:返回计算结果

语法:

array.reduce(function(total, currentValue, currentIndex, arr), initialValue)
total	必需。初始值, 或者计算结束后的返回值。
currentValue	必需。当前元素
currentIndex	可选。当前元素的索引
arr	可选。当前元素所属的数组对象。
initialValue	可选。传递给函数的初始值

14.slice()

作用:从已有的数组中返回选定的元素(包头不包尾)

返回值:

返回一个新的数组，包含从 start（包括该元素） 到 end （不包括该元素）的

arrayObject 中的元素

语法:

array.slice(start, end)
start	可选。规定从何处开始选取。如果该参数为负数，
则表示从原数组中的倒数第几个元素开始提取，
slice(-2) 表示提取原数组中的倒数第二个元素到最后一个元素（包含最后一个元素）。
end	可选。规定从何处结束选取。该参数是数组片断结束处的数组下标。
如果没有指定该参数，那么切分的数组包含从 start 到数组结束的所有元素。
如果该参数为负数， 则它表示在原数组中的倒数第几个元素结束抽取。 
slice(-2,-1) 表示抽取了原数组中的倒数第二个元素到最后一个元素
（不包含最后一个元素，也就是只有倒数第二个元素）。

15.some()

作用:用于检测数组中的元素是否满足指定条件（函数提供）

返回值:布尔值。如果数组中有元素满足条件返回 true，否则返回 false

语法:

array.some(function(currentValue,index,arr),thisValue)
currentValue	必须。当前元素的值
index	可选。当前元素的索引值
arr	可选。当前元素属于的数组对象
thisValue	可选。对象作为该执行回调时使用，传递给函数，用作 "this" 的值。
如果省略了 thisValue ，"this" 的值为 "undefined"

16.toString()

作用:可把数组转换为字符串

返回值:数组的所有值用逗号隔开

语法:

array.toString()