数组的方法

闲来无事，整理了一个Js中数组常用的方法。

文档来源： MDN 文档

写在最前面

Array被归类为JavaScript 标准内置对象，意味着：

typeof new Array()
typeof []
typeof Array // Array 为构造函数

// Logs
// object
// object
// function

静态方法

Array.from

为了精简代码，以下使用Typscript风格书写伪代码。

Array.from(arrayLike, mapFn?, thisArg?)

arrayLike: 需要转换成数组的可迭代对象

mapFn: 对每个参数作出处理的函数，返回处理后的值

thisArg: 执行 mapFn 时用作 this 的值。

返回一个新的数组实例，这个数组来源于arrayLike的浅拷贝，如果其中item是引用类型，修改后会同时影响两者的值

Array.fromAsync

Array.from的异步版本，返回Promise<Array>，即使你传入的是同步代码，也会包装一层Promise。

这个方法和Promise.all的区别：这个是会同步等待的，即必须等待上一个处理完成后再进行下一次处理，而Promise.all是并行处理的

Array.isArray

检测是否为数组，，两个比较特殊的情况：

Array.isArray(Array.prototype);
// true, 因为Array.prototype也是一个数组

Array.isArray({ __proto__: Array.prototype });
// false，因为它不是使用数组字面量语法或 Array 构造函数创建的

Array.of

Array.of(element0, element1, /* … ,*/ elementN)

返回由传入element构成的数组。

实例方法

Array.prototype.at

返回对应位置的值，同时支持传入：

正整数：和array[x]等价

负整数：数组倒数x位置的值

小数：会转换为整数，仅保留整数部分再进行取值

Array.prototype.concat

用于合并两个或多个数组。此方法不会更改现有数组，而是返回一个新数组。但依旧是浅拷贝。

array1.concat(value0, value1, /* … ,*/ valueN)

Array.prototype.copyWithin

浅复制数组的一部分到同一数组中的另一个位置，并返回它，不会改变原数组的长度。

array.copyWithin(target, start? = 0, end? = array.length)

对array 数组，把下标start到end（左含右不含）的数据从target位置开始替换

这个方法不会改变原数组长度，但会改变原数组的值

边界情况：

target超出数组范围、start超出数组范围、end 指向对位置小于start 指向对位置时，这个方法都不会对array进行处理

当end超出数组长度时，会被处理成 array.length

Array.prototype.entries

返回一个新的数组迭代器对象，该对象包含数组中每个索引的键/值对。

Array.prototype.every

方法测试一个数组内的所有元素是否都能通过指定函数的测试，返回布尔值

Array.prototype.fill

array.fill(value, start? = 0, end? = array.length)

规则和Array.prototype.copyWithin一致，只不过填的都是同一个value 值

Array.prototype.filter

创建给定数组一部分的浅拷贝，其包含通过所提供函数实现的测试的所有元素。

Array.prototype.find、Array.prototype.findLast

返回数组中满足提供的测试函数的第一个、最后一个元素的值，没有就返回undefined

Array.prototype.findIndex、Array.prototype.findLastIndex

返回数组中满足提供的测试函数的第一个、最后一个元素的索引。若没有找到对应元素则返回 -1。

Array.prototype.flat

创建一个新的数组，并根据指定深度递归地将所有子数组元素拼接到新的数组中。

array.flat(depth? = 1)

这个方法会跳过数组中的空值，所以可以用于删除数组中的空槽

Array.prototype.flatMap

对数组中的每个元素应用给定的回调函数，然后将结果展开一级，返回一个新数组。它等价于在调用 map() 方法后再调用深度为 1 的 flat() 方法

Array.prototype.forEach

对数组的每个元素执行一次给定的函数

array.forEach(callbackFn, thisArg?)

callbackFunc: 需要执行的方法，这个方法的返回值会被丢弃，forEach中只会返回undefined。支持参数：

element
数组中正在处理的当前元素。
index
数组中正在处理的当前元素的索引。
array
调用了 forEach() 的数组本身。

thisArg: 执行 callbackFn 时用作 this 的值。

特性

除非抛出异常，否则没有办法停止或中断 forEach() 循环。

forEach() 期望的是一个同步函数，它不会等待 Promise 兑现。

forEach() 会跳过数组中的空值

不要在callbackFunc中修改原数组，forEach 遍历的是数组下标，如果对应的位置值变了，这个方法会使用新的值

Array.prototype.includes

用来判断一个数组是否包含一个指定的值，根据情况，如果包含则返回 true，否则返回 false。

array.includes(searchElement, fromIndex? = 0)

searchElement: 需要搜索的目标

fromIndex: 开始搜索的索引位置，支持正数负数和小数，处理逻辑和之前几个方法一致

使用零值相等算法将 searchElement 与数组中的元素进行比较。0 值都被认为是相等的，不管符号是什么。（即 -0 等于 0），但 false 不被认为与 0 相同。NaN可以被正确搜索到

Array.prototype.indexOf、Array.prototype.lastIndexOf

返回数组中第一次、最后一次出现给定元素的下标，如果不存在则返回 -1

array.indexOf(searchElement, fromIndex? = 0)
array.lastIndexOf(searchElement, fromIndex? = 0)

参数含义和includes一致，无法找到NaN

Array.prototype.join

将一个数组（或一个类数组对象）的所有元素连接成一个字符串并返回这个字符串，用逗号或指定的分隔符字符串分隔。如果数组只有一个元素，那么将返回该元素而不使用分隔符。

array.join(separator? = ',')

所有数组元素被转换成字符串并连接到一个字符串中。如果一个元素是 undefined 或 null，它将被转换为空字符串，而不是字符串 "undefined" 或 "null"。

Array.prototype.toString() 会在内部访问 join 方法，不带参数。覆盖一个数组实例的 join 也将覆盖它的 toString 行为。

Array.prototype.keys

返回一个新的数组迭代器对象，其中包含数组中每个索引的键

与 Object.keys() 只包含数组中实际存在的键不同，keys() 迭代器不会忽略缺失属性的键。

Array.prototype.map

创建一个新数组，这个新数组由原数组中的每个元素都调用一次提供的函数后的返回值组成。

array.map(callbackFn, thisArg)

callbackFn会跳过执行数组内空槽，且和forEach一样，不要在callbackFn中修改array数组，因为它认下标。

Array.prototype.pop

从数组中删除最后一个元素，并返回该元素的值。此方法会更改数组的长度。

Array.prototype.push

将指定的元素添加到数组的末尾，并返回新的数组长度。

Array.prototype.reduce

数组中的每个元素按序执行一个提供的 reducer 函数，每一次运行 reducer 会将先前元素的计算结果作为参数传入，最后将其结果汇总为单个返回值。

array.reduce(callbackFn, initialValue)

callbackFn

为数组中每个元素执行的函数。其返回值将作为下一次调用 callbackFn 时的 accumulator 参数。对于最后一次调用，返回值将作为 reduce() 的返回值。该函数被调用时将传入以下参数：

accumulator
上一次调用 callbackFn 的结果。在第一次调用时，如果指定了 initialValue 则为指定的值，否则为 array[0] 的值。
currentValue
当前元素的值。在第一次调用时，如果指定了 initialValue，则为 array[0] 的值，否则为 array[1]。
currentIndex
currentValue 在数组中的索引位置。在第一次调用时，如果指定了 initialValue 则为 0，否则为 1。
array
调用了 reduce() 的数组本身。

initialValue

第一次调用回调时初始化 accumulator 的值。如果指定了 initialValue，则 callbackFn 从数组中的第一个值作为 currentValue 开始执行。如果没有指定 initialValue，则 accumulator 初始化为数组中的第一个值，并且 callbackFn 从数组中的第二个值作为 currentValue 开始执行。在这种情况下，如果数组为空（没有第一个值可以作为 accumulator 返回），则会抛出错误。

Array.prototype.reduceRight()

reduce的从右往左版本

Array.prototype.reverse

reverse() 方法就地反转数组中的元素，并返回同一数组的引用，这种方法会修改原数组。

Array.prototype.toReverse

reverse()的不修改原数组版本，会返回反转后的复制数组（浅拷贝）

Array.prototype.shift

从数组中删除第一个元素，并返回该元素的值。此方法更改数组的长度。

Array.prototype.slice

返回一个新的数组对象，这一对象是一个由 start 和 end 决定的原数组的浅拷贝（包括 start，不包括 end），其中 start 和 end 代表了数组元素的索引。原始数组不会被改变。

array.slice(start? = 0, end? = 0)

同样支持正数负数和小数，且会保留空值

Array.prototype.some

some() 方法测试数组中是否至少有一个元素通过了由提供的函数实现的测试。如果在数组中找到一个元素使得提供的函数返回 true，则返回 true；否则返回 false。它不会修改数组。

这个方法会在检测到第一个true时立即结束并返回true，不会再对后续元素作判断

Array.prototype.sort

对原数组的元素进行排序，并返回对相同数组的引用。默认排序是将元素转换为字符串，然后按照它们的 UTF-16 码元值升序排序。

array.sort(compareFn?)

compareFn: 支持两个参数a，b，返回值规则：

大于0交换顺序，小于等于0保持顺序

一个判断数字排序的例子：

[3, 1, 2, 4].sort((a, b) => a - b)

// [1, 2, 3, 4] 从左到右升序排列

Array.prototype.toSorted

sort的不修改原数组版本，会浅拷贝一份数组再进行排序

Array.prototype.splice

移除或者替换已存在的元素和/或添加新的元素，会修改原数组。

array.splice(start, deleteCount, item1, item2, /* …, */ itemN)

start: 从 0 开始计算的索引，支持正数负数和小数

deleteCount:一个整数，表示数组中要从 start 开始删除的元素数量。如果省略了 deleteCount，或者其值大于或等于由 start 指定的位置到数组末尾的元素数量，那么从 start 到数组末尾的所有元素将被删除。但是，如果你想要传递任何 itemN 参数，则应向 deleteCount 传递 Infinity 值，以删除 start 之后的所有元素，因为显式的 undefined 会转换为 0。如果 deleteCount 是 0 或者负数，则不会移除任何元素。在这种情况下，你应该至少指定一个新元素（请参见下文）。

item1、…、itemN : 从 start 开始要加入到数组中的元素。如果不指定任何元素，splice() 将只从数组中删除元素。

此方法不会跳过数组空槽

Array.prototype.toSpliced

splice的不修改原数组版本

Array.prototype.toLocalString

返回一个字符串，表示数组中的所有元素。每个元素通过调用它们自己的 toLocaleString 方法转换为字符串，并且使用特定于语言环境的字符串（例如逗号“,”）分隔开

array.toLocaleString(locales?, options?)

locales: 带有 BCP 47 语言标签的字符串，或者此类字符串的数组。

options: 一个具有配置属性的对象。根据里面的数据不同需要options支持的选项也不同

Array.prototype.toString

toString() 方法返回一个字符串，表示指定的数组及其元素。

Array.prototype.unshift

将指定元素添加到数组的开头，并返回数组的新长度

array.unshift(element1, element2, /* …, */ elementN)

Array.prototype.values

返回一个新的数组迭代器对象，该对象迭代数组中每个元素的值。

Array.prototype.with

是使用方括号表示法修改指定索引值的复制方法版本。它会返回一个新数组，其指定索引处的值会被新值替换。不会修改原数组

arrayInstance.with(index, value)

index: 需要替换的位置，支持正数负数和小数

value: 需要替换的值

Js数组

标签

文章助手

推荐文章

String方法总结

Object常用方法

Promise方法