如何使用 JavaScript 遍历数组中的所有条目?
我以为是这样的:
forEach(instance in theArray)
theArray我的数组在哪里,但这似乎不正确。
theArray
TL; DR
你最好的选择通常是
一个for-of循环(仅限 ES2015+;规范| MDN)——简单且async友好
for-of
async
for (const element of theArray) { // ...use `element`... }
forEach(ES5 +只;规格| MDN)(或其亲属some和这样) -不 async-友好(而见详情)
forEach
some
theArray.forEach(element => { // ...use `element`... });
一个简单的老式for循环——async友好
for
for (let index = 0; index < theArray.length; ++index) { const element = theArray[index]; // ...use `element`... }
(很少) for-in 有保护措施- -async友好
for-in
for (const propertyName in theArray) { if (/*...is an array element property (see below)...*/) { const element = theArray[propertyName]; // ...use `element`... } }
一些快速的“不要”:
不要使用,for-in除非您使用它有安全措施,或者至少知道它为什么会咬你。
map
但是还有很多东西要探索,请继续阅读…
JavaScript 具有强大的语义来循环遍历数组和类数组对象。我将答案分为两部分:真正数组的选项,以及类似数组的选项,例如arguments对象、其他可迭代对象 (ES2015+)、DOM 集合等。
arguments
好的,让我们看看我们的选择:
您有五个选项(两个基本上永久支持,另一个由 ECMAScript 5 [“ES5”] 添加,另外两个在 ECMAScript 2015(“ES2015”,又名“ES6”)中添加:
(你可以在这里看到那些旧的规范:ES5,ES2015,但两者都被取代了;当前编辑的草稿总是在这里。)
细节:
ES2015向 JavaScript添加了迭代器和可迭代对象。数组是可迭代的(字符串、Maps 和Sets 以及 DOM 集合和列表也是如此,稍后您将看到)。可迭代对象为其值提供迭代器。newfor-of语句循环遍历迭代器返回的值:
Map
Set
const a = ["a", "b", "c"]; for (const element of a) { // You can use `let` instead of `const` if you like console.log(element); } // a // b // c
没有比这更简单的了!在幕后,它从数组中获取一个迭代器并遍历迭代器返回的值。数组提供的迭代器提供数组元素的值,从开始到结束。
注意element每个循环迭代的范围如何;尝试element在循环结束后使用会失败,因为它不存在于循环体之外。
element
理论上,一个for-of循环涉及多个函数调用(一个用于获取迭代器,然后一个用于从中获取每个值)。即使这是真的,也没有什么可担心的,现代 JavaScript 引擎中的函数调用非常便宜(它困扰着我forEach[below] 直到我研究它;细节)。但此外,在处理数组等本机迭代器时,JavaScript 引擎会优化这些调用(在性能关键代码中)。
for-of是完全async友好的。如果您需要在循环体中串联(而不是并行)完成工作,则循环体中的一个awaitin 循环体将在继续之前等待承诺解决。这是一个愚蠢的例子:
await
function delay(ms) { return new Promise(resolve => { setTimeout(resolve, ms); }); } async function showSlowly(messages) { for (const message of messages) { await delay(400); console.log(message); } } showSlowly([ "So", "long", "and", "thanks", "for", "all", "the", "fish!" ]); // `.catch` omitted because we know it never rejects
请注意这些词是如何在每个词之前延迟出现的。
这是编码风格的问题,但这for-of是我在遍历任何可迭代的东西时首先要接触的东西。
在任何可以访问ArrayES5 添加的功能的模糊现代环境(因此,不是 IE8)中,如果您只处理同步代码(或者您不需要等待),则可以使用forEach( spec | MDN )用于在循环期间完成的异步进程):
Array
const a = ["a", "b", "c"]; a.forEach((element) => { console.log(element); });
forEach接受一个回调函数和一个可选的值,作为this调用该回调时使用的值(上面未使用)。为数组中的每个元素调用回调,按顺序跳过稀疏数组中不存在的元素。虽然我只使用了上面的一个参数,但是回调函数是用三个参数调用的:该迭代的元素、该元素的索引以及对您正在迭代的数组的引用(以防您的函数还没有它便利)。
this
像for-of,forEach的优点是您不必在包含范围内声明索引和值变量;在这种情况下,它们作为迭代函数的参数提供,并且很好地限定在该迭代中。
与for-of,forEach的缺点是它不理解async函数和await. 如果您使用async函数作为回调,forEach则在继续之前不等待该函数的承诺解决。这是使用替代的async示例- 请注意初始延迟是如何出现的,但随后所有文本都会立即出现而不是等待:for-of``forEach
for-of``forEach
function delay(ms) { return new Promise(resolve => { setTimeout(resolve, ms); }); } async function showSlowly(messages) { // INCORRECT, doesn't wait before continuing, // doesn't handle promise rejections messages.forEach(async message => { await delay(400); console.log(message); }); } showSlowly([ "So", "long", "and", "thanks", "for", "all", "the", "fish!" ]); // `.catch` omitted because we know it never rejects
forEach 是“循环遍历所有”函数,但 ES5 定义了其他几个有用的“遍历数组并执行操作”函数,包括:
every
filter
reduce
reduceRight
和 一样forEach,如果你使用一个async函数作为你的回调函数,那么这些函数都不会等待函数的承诺完成。这意味着:
Promise.all
Promise.race
promise.allSettled
Promise.any
const promise = array.reduce((p, element) => p.then(/*...something using
...*/));
有时旧的方法是最好的:
const a = ["a", "b", "c"]; for (let index = 0; index < a.length; ++index) { const element = a[index]; console.log(element); }
如果数组的长度将不会在循环过程中改变,它在高的性能敏感的代码,一个稍微复杂一点的版本抓住了长度达阵可能是一个很小的有点快:
const a = ["a", "b", "c"]; for (let index = 0, len = a.length; index < len; ++index) { const element = a[index]; console.log(element); }
And/or 倒数:
const a = ["a", "b", "c"]; for (let index = a.length - 1; index >= 0; --index) { const element = a[index]; console.log(element); }
但是对于现代 JavaScript 引擎,您很少需要勉强挤出最后一点力气。
在 ES2015 之前,循环变量必须存在于包含作用域中,因为var只有函数级作用域,没有块级作用域。但是正如您在上面的示例中看到的那样,您可以let在 内使用for将变量范围限定为循环。当你这样做时,index每次循环迭代都会重新创建变量,这意味着在循环体中创建的闭包会保留index对特定迭代的引用,这解决了旧的“循环中的闭包”问题:
var
let
index
// (The `NodeList` from `querySelectorAll` is array-like) const divs = document.querySelectorAll("div"); for (let index = 0; index < divs.length; ++index) { divs[index].addEventListener('click', e => { console.log("Index is: " + index); }); } <div>zero</div> <div>one</div> <div>two</div> <div>three</div> <div>four</div>
在上面,如果你点击第一个,你会得到“Index is: 0”,如果你点击最后一个,你会得到“Index is: 4”。这并没有,如果你使用的工作var,而不是let(你永远看“:5指数”)。
就像for-of,for循环在async函数中运行良好。这是使用for循环的较早示例:
Show code snippet
for-in不是用于遍历数组,而是用于遍历对象属性的名称。作为数组是对象这一事实的副产品,它似乎经常用于循环遍历数组,但它不仅循环遍历数组索引,还循环遍历对象的所有可枚举属性(包括继承的属性)。
for-in数组上唯一真正的用例是:
仅查看第一个示例:for-in如果您使用适当的保护措施,您可以使用访问那些稀疏数组元素:
// `a` is a sparse array const a = []; a[0] = "a"; a[10] = "b"; a[10000] = "c"; for (const name in a) { if (Object.hasOwn(a, name) && // These checks are /^0$|^[1-9]\d*$/.test(name) && // explained name <= 4294967294 // below ) { const element = a[name]; console.log(a[name]); } }
注意三项检查:
a.hasOwnProperty(name)
Object.hasOwn
length
…尽管如此,大多数代码只进行hasOwnProperty检查。
hasOwnProperty
当然,您不会在内联代码中这样做。你会写一个实用程序函数。也许:
// Utility function for antiquated environments without `forEach` const hasOwn = Object.prototype.hasOwnProperty.call.bind(Object.prototype.hasOwnProperty); const rexNum = /^0$|^[1-9]\d*$/; function sparseEach(array, callback, thisArg) { for (const name in array) { const index = +name; if (hasOwn(a, name) && rexNum.test(name) && index <= 4294967294 ) { callback.call(thisArg, array[name], index, array); } } } const a = []; a[5] = "five"; a[10] = "ten"; a[100000] = "one hundred thousand"; a.b = "bee"; sparseEach(a, (value, index) => { console.log("Value at " + index + " is " + value); });
像for,for-in如果其中的工作需要串行完成,则在异步函数中效果很好。
function delay(ms) { return new Promise(resolve => { setTimeout(resolve, ms); }); } async function showSlowly(messages) { for (const name in messages) { if (messages.hasOwnProperty(name)) { // Almost always this is the only check people do const message = messages[name]; await delay(400); console.log(message); } } } showSlowly([ "So", "long", "and", "thanks", "for", "all", "the", "fish!" ]); // `.catch` omitted because we know it never rejects
for-of隐式使用迭代器,为您完成所有 scut 工作。有时,您可能希望显式使用迭代器。它看起来像这样:
const a = ["a", "b", "c"]; const it = a.values(); // Or `const it = a[Symbol.iterator]();` if you like let entry; while (!(entry = it.next()).done) { const element = entry.value; console.log(element); }
迭代器是与规范中的迭代器定义相匹配的对象。每次调用它的next方法时,它都会返回一个新的结果对象。结果对象有一个属性 ,done告诉我们它是否完成,还有一个属性value包含该迭代的值。(done如果是false,value则是可选的,如果是,则是可选的undefined。)
next
done
value
false
undefined
你得到的东西value取决于迭代器。阵列上,缺省迭代器提供每个阵列元素的值("a","b",和"c"在前面的例子)。数组还有其他三个返回迭代器的方法:
"a"
"b"
"c"
values()
[Symbol.iterator]
keys()
"0"
"1"
"2"
entries()
[key, value]
由于迭代器对象在您调用 之前不会前进next,因此它们在async函数循环中运行良好。这是先前for-of明确使用迭代器的示例:
function delay(ms) { return new Promise(resolve => { setTimeout(resolve, ms); }); } async function showSlowly(messages) { const it = messages.values() while (!(entry = it.next()).done) { await delay(400); const element = entry.value; console.log(element); } } showSlowly([ "So", "long", "and", "thanks", "for", "all", "the", "fish!" ]); // `.catch` omitted because we know it never rejects
除了真正的数组,还有类似数组的对象,它们有一个length属性和全数字名称的属性:NodeListinstances、HTMLCollectioninstances、argumentsobject 等。我们如何遍历它们的内容?
NodeList
HTMLCollection
上面的数组方法中至少有一些,可能是大部分甚至全部,同样适用于类似数组的对象:
for-of使用对象提供的迭代器(如果有)。这包括主机提供的对象(如 DOM 集合和列表)。例如,HTMLCollection来自getElementsByXYZ方法NodeList的实例和来自querySelectorAll两者的s 实例都支持迭代。(这是由 HTML 和 DOM 规范非常巧妙地定义的。基本上,任何具有length和 索引访问的对象都是自动可迭代的。它不必被标记iterable;这仅用于集合,除了可迭代之外,还支持forEach,values, keys, 和entriesmethods. NodeListdo; HTMLCollectionnot, 但两者都是可迭代的。)
getElementsByXYZ
querySelectorAll
iterable
values
keys
entries
下面是一个循环遍历div元素的例子:
div
on 的各种函数Array.prototype是“有意通用的”,可以通过Function#call( spec | MDN ) 或Function#apply( spec | MDN )用于类数组对象。(如果您必须处理 IE8 或更早版本 [哎哟],请参阅本答案末尾的“主机提供对象的警告”,但这对于模糊现代的浏览器来说不是问题。)
Array.prototype
Function#call
Function#apply
假设您想forEach在 aNode的childNodes集合上使用(作为 ,本机HTMLCollection没有forEach)。你会这样做:
Node
childNodes
js Array.prototype.forEach.call(node.childNodes, (child) => { // Do something with `child` });
(但请注意,您可以只使用for-ofon node.childNodes。)
node.childNodes
如果您打算经常这样做,您可能希望将函数引用的副本抓取到变量中以供重用,例如:
```js // (This is all presumably in a module or some scoping function) const forEach = Array.prototype.forEach.call.bind(Array.prototype.forEach);
// Then later… forEach(node.childNodes, (child) => { // Do something with child }); ```
child
也许很明显,一个简单的for循环适用于类似数组的对象。
见#1。
您可能能够逃脱for-in(使用安全措施),但是有了所有这些更合适的选项,就没有理由尝试了。
其他时候,您可能希望将类似数组的对象转换为真正的数组。做到这一点非常简单:
Array.from
Array.from (规格) | (MDN)(ES2015+,但很容易填充)从一个类似数组的对象创建一个数组,可以选择首先通过映射函数传递条目。所以:
js const divs = Array.from(document.querySelectorAll("div"));
…获取NodeListfromquerySelectorAll并从中创建一个数组。
如果您打算以某种方式映射内容,映射功能会很方便。例如,如果您想获取具有给定类的元素的标签名称数组:
```js // Typical use (with an arrow function): const divs = Array.from(document.querySelectorAll(“.some-class”), element => element.tagName);
// Traditional function (since Array.from can be polyfilled): var divs = Array.from(document.querySelectorAll(“.some-class”), function(element) { return element.tagName; }); ```
...
也可以使用 ES2015 的扩展语法。就像for-of,这使用了对象提供的迭代器(参见上一节中的 #1):
js const trueArray = [...iterableObject];
因此,例如,如果我们想将 a 转换NodeList为一个真正的数组,使用展开语法这会变得非常简洁:
js const divs = [...document.querySelectorAll("div")];
slice
我们可以使用slice数组的方法,与上面提到的其他方法一样,它是“有意通用的”,因此可以与类似数组的对象一起使用,如下所示:
js const trueArray = Array.prototype.slice.call(arrayLikeObject);
因此,例如,如果我们想将 aNodeList转换为真正的数组,我们可以这样做:
js const divs = Array.prototype.slice.call(document.querySelectorAll("div"));
(如果您仍然必须处理 IE8 [哎哟],将会失败;IE8 不允许您像this那样使用主机提供的对象。)
如果您使用主机提供的类似数组的对象的Array.prototype函数(例如,DOM 集合等由浏览器而不是 JavaScript 引擎提供),像 IE8 这样过时的浏览器不一定会处理这种方式,所以如果您必须支持它们,请务必在您的目标环境中进行测试。但这对于模糊现代的浏览器来说不是问题。(对于非浏览器环境,自然会因环境而异。)