Array：length

BaselineWidely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

length 是Array 的实例属性，表示该数组中元素的个数。该值是一个无符号 32 位整数，并且其数值总是大于数组最大索引。

尝试一下

const clothing = ["shoes", "shirts", "socks", "sweaters"];console.log(clothing.length);// Expected output: 4

值

一个小于 2³² 的非负整数。

`Array：length` 的属性特性
可写	是
可枚举	否
可配置	否

描述

length 属性的值是一个小于 2³² 的非负整数

const listA = [1, 2, 3];const listB = new Array(6);console.log(listA.length);// 3console.log(listB.length);// 6listB.length = 2 ** 32; // 4294967296// RangeError: Invalid array lengthconst listC = new Array(-100); // 负数是不允许的// RangeError: Invalid array length

数组对象会观察length 属性，并自动将length 值与数组的内容同步。这意味着：

设置length 小于当前长度的值将会截断数组——超过新length 的元素将被删除。
设置超过当前length 的任何数组索引（小于 2³² 的非负整数）将会扩展数组——length 属性增加以反映新的最高索引。
将length 设置为无效值（例如负数或非整数）会引发RangeError 异常。

当length 被设置为比当前长度更大的值时，数组通过添加空槽来扩展，而不是实际的undefined 值。空槽与数组方法有一些特殊的交互作用；详见数组方法和空槽。

const arr = [1, 2];console.log(arr);// [ 1, 2 ]arr.length = 5; // 将数组长度设置为 5，而当前为 2。console.log(arr);// [ 1, 2, <3 empty items> ]arr.forEach((element) => console.log(element));// 1// 2

另请参阅：length 与数值属性的关系。

示例

遍历数组

在下面的示例中，通过查看length 属性来遍历数组numbers。然后将每个元素中的值加倍。

const numbers = [1, 2, 3, 4, 5];const length = numbers.length;for (let i = 0; i < length; i++) {  numbers[i] *= 2;}// 遍历后的结果 [2, 4, 6, 8, 10]

截断数组

在下面的示例中，如果当前长度大于 3，数组numbers 将会缩短为 3。

const numbers = [1, 2, 3, 4, 5];if (numbers.length > 3) {  numbers.length = 3;}console.log(numbers); // [1, 2, 3]console.log(numbers.length); // 3console.log(numbers[3]); // undefined；多余的元素会被删除

创建固定长度的空数组

将length 设置为大于当前长度的值将会创建一个稀疏数组。

const numbers = [];numbers.length = 3;console.log(numbers); // [empty x 3]

长度不可写的数组

当添加的元素超过当前长度时，数组会自动更新length 属性。如果length 属性设置为不可写，则数组将无法更新它。在严格模式中这会导致错误。

"use strict";const numbers = [1, 2, 3, 4, 5];Object.defineProperty(numbers, "length", { writable: false });numbers[5] = 6; // TypeError: Cannot assign to read only property 'length' of object '[object Array]'numbers.push(5); // // TypeError: Cannot assign to read only property 'length' of object '[object Array]'