Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

`length`: zapisovatelná vlastnost pole

Přečtením `arr.length` zjistíte délku pole. Přiřazením do této vlastnosti můžete totéž pole zkrátit nebo prodloužit bez vytvoření prvků.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

arr.length
arr.length = newLength

arr.length je vlastní datová vlastnost instance Array, nikoli vlastnost length konstruktoru Array. Zpočátku je zapisovatelná, ale není vyjmenovatelná ani konfigurovatelná. Její hodnota je větší než každý vlastní index pole a může přesahovat počet existujících prvků.

Zmenšením length se odstraní vlastní prvky s indexem rovným nové délce nebo vyšším. arr.length = 0 vyprázdní běžné pole bez jeho nahrazení: změna je viditelná přes všechny reference na totéž pole. Zvětšením délky vzniknou prázdné pozice, nikoli prvky s hodnotou undefined, a odstraněné prvky se neobnoví. Vytvořením prvku na platném indexu i, který je roven dosavadní délce nebo je vyšší, se délka zvětší na i + 1.

Délka je celé číslo typu Number od 0 do 2 ** 32 - 1 včetně. Při přiřazení do zapisovatelné vlastnosti length se hodnota převede: například "3" se přijme jako 3, ale 2.5, -1 a 2 ** 32 vyvolají RangeError. Převod hodnoty typu Symbol nebo BigInt místo toho vyvolá TypeError.

Pokud zkracování narazí na nekonfigurovatelný prvek, zastaví se na jeho indexu. Délka se nastaví na tento index plus jedna a již odstraněné prvky s vyššími indexy se neobnoví. Pomocí writable: false lze také trvale zakázat zápis do length. To blokuje přiřazení do length a přidávání prvků, které by pole prodloužily, ale ne všechny změny prvků. V obou případech neúspěšné přiřazení v přísném režimu vyvolá TypeError; mimo něj výjimku nevyvolá.

Příklady

(() => {
  "use strict";
  const arr = ["a", "b", "c"];
  const alias = arr;

  arr.length = 1;
  console.log(`${alias.length}: ${alias.join(",")}`);

  arr.length = 3;
  arr[2] = undefined;
  console.log(`${arr.length}: ${Object.hasOwn(arr, 1)}, ${Object.hasOwn(arr, 2)}`);

  arr[4] = "e";
  console.log(`${arr.length}: ${arr[4]}`);

  try {
    arr.length = 2.5;
  } catch (error) {
    console.log(`${error.name}: ${arr.length}`);
  }
})();

Výsledek

1: a
3: false, true
5: e
RangeError: 5

Přes `alias` je vidět zkrácení téhož pole. Po prodloužení `Object.hasOwn` rozliší prázdnou pozici na indexu `1` od výslovně přiřazené hodnoty `undefined` na indexu `2`. Zápis na index `4` zvýší délku na `5`; odmítnutá hodnota `2.5` ji nezmění.

Související lekce

  • JavaScript · Lekce 20 · Pokročilá · Verze: 4

Zdroje