CKTIS / JavaScript
`length`: zapisovateľná vlastnosť poľa
Prečítaním `arr.length` zistíš dĺžku poľa. Priradením do tejto vlastnosti môžeš to isté pole skrátiť alebo predĺžiť bez vytvorenia prvkov.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
arr.length
arr.length = newLengtharr.length je vlastná dátová vlastnosť inštancie Array, nie vlastnosť length konštruktora Array. Spočiatku je zapisovateľná, no nie je vymenovateľná ani konfigurovateľná. Jej hodnota je väčšia než každý vlastný index poľa a môže presiahnuť počet existujúcich prvkov.
Zmenšením length sa odstránia vlastné prvky s indexom rovným novej dĺžke alebo vyšším. arr.length = 0 vyprázdni bežné pole bez jeho nahradenia: zmenu vidno cez všetky referencie na to isté pole. Zväčšením dĺžky vzniknú prázdne pozície, nie prvky s hodnotou undefined, a odstránené prvky sa neobnovia. Vytvorením prvku na platnom indexe i, ktorý je rovný aktuálnej dĺžke alebo je vyšší, sa dĺžka zväčší na i + 1.
Dĺžka je celé číslo typu Number od 0 do 2 ** 32 - 1 vrátane. Pri zápise do zapisovateľnej vlastnosti length sa hodnota konvertuje: napríklad "3" sa prijme ako 3, ale 2.5, -1 a 2 ** 32 vyvolajú RangeError. Konverzia hodnoty typu Symbol alebo BigInt namiesto toho vyvolá TypeError.
Ak skracovanie narazí na nekonfigurovateľný prvok, zastaví sa na jeho indexe. Dĺžka sa nastaví na tento index plus jeden a už odstránené prvky s vyššími indexmi sa neobnovia. Pomocou writable: false možno aj natrvalo zakázať zápis do length. Tým sa zablokujú priradenia do length a pridávanie prvkov, ktoré by pole predĺžili, nie však všetky zmeny prvkov. V oboch prípadoch neúspešné priradenie v prísnom režime vyvolá TypeError; mimo neho výnimku nevyvolá.
Prí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ýsledok
1: a 3: false, true 5: e RangeError: 5
Cez `alias` vidno skrátenie toho istého poľa. Po predĺžení `Object.hasOwn` rozlíši prázdnu pozíciu na indexe `1` od výslovne priradenej hodnoty `undefined` na indexe `2`. Zápis na index `4` zvýši dĺžku na `5`; odmietnutá hodnota `2.5` ju nezmení.
Súvisiace lekcie
- JavaScript · Lekcia 20 · Pokročilá · Verzia: 4