Array.length
Baseline Widely 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 位元、且恆大於該陣列最大索引數的正整數。
js
var items = ["shoes", "shirts", "socks", "sweaters"];
items.length;
// returns 4
描述
length
屬性的值必為一正整數,其值必介於 0 ~ 2^32 (不包含)之間.
js
var namelistA = new Array(4294967296); //2^32 = 4294967296
var namelistC = new Array(-100); //負數
console.log(namelistA.length); //RangeError: Invalid array length
console.log(namelistC.length); //RangeError: Invalid array length
var namelistB = [];
namelistB.length = Math.pow(2, 32) - 1; //將長度設定介於 0 ~ 2^32 -1
console.log(namelistB.length);
//4294967295
你可以透過改變 length
屬性來改變陣列的長度。當你透過 length
屬性來增加陣列的長度時,陣列中實際的元素也會隨之增加。舉例來說,當你將 array.length 由 2 增加為 3,則改動後該陣列即擁有 3 個元素,該新增的元素則會是一個不可迭代(non-iterable)的空槽(empty slot)。
const arr = [1, 2]; console.log(arr); // [ 1, 2 ] arr.length = 5; // 將arr的length由2改成5 console.log(arr); // [ 1, 2, <3 empty items> ] arr.forEach(element => console.log(element)); // 空元素無法被迭代 // 1 // 2
如上所見,length
屬性不盡然代表陣列中所有已定義的元素個數。詳見 length 與數值屬性的關係。
Property attributes of Array.length 的屬性特性 | |
---|---|
可寫 | 是 |
可列舉 | 否 |
可配置 | 否 |
範例
對陣列進行迭代處理
以下範例中, 陣列 numbers
透過 length
屬性進行迭代操作,並將其內容值加倍。
js
var numbers = [1, 2, 3, 4, 5];
var length = numbers.length;
for (var i = 0; i < length; i++) {
numbers[i] *= 2;
}
// numbers 內容值變為 [2, 4, 6, 8, 10]
縮減陣列
以下範例中, 陣列 numbers
的長度若大於 3,則將其長度縮減至 3。
js
var numbers = [1, 2, 3, 4, 5];
if (numbers.length > 3) {
numbers.length = 3;
}
console.log(numbers); // [1, 2, 3]
console.log(numbers.length); // 3
規範
Specification |
---|
ECMAScript Language Specification # sec-properties-of-array-instances-length |
瀏覽器相容性
BCD tables only load in the browser