Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

TypedArray.byteLength — dĺžka pohľadu v bajtoch

Vlastnosť byteLength udáva počet bajtov, ktoré pokrýva pohľad na typované pole, nie počet jeho prvkov ani veľkosť celého buffera. Číta sa z inštancie a nemá setter.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

typedArray.byteLength

TypedArray.byteLength tu označuje vlastnosť inštancie, formálne nazvanú TypedArray.prototype.byteLength. Číta sa ako typedArray.byteLength, bez zátvoriek. TypedArray nie je globálny konštruktor; použite konkrétny typ, napríklad Uint16Array. Vlastnosť nemá setter: priradenie hodnoty nezmení veľkosť pohľadu.

length počíta prvky, zatiaľ čo byteLength počíta bajty: typedArray.byteLength === typedArray.length * typedArray.BYTES_PER_ELEMENT. Naproti tomu typedArray.buffer.byteLength opisuje celý buffer a byteOffset udáva začiatok pohľadu v bajtoch. Pohľad môže pokrývať iba časť buffera; jeho byteLength nie je mierou celkovej spotreby pamäte objektu.

Pri buffri s meniteľnou veľkosťou sa byteLength pohľadu, ktorý sleduje dĺžku, môže meniť. Pohľad s pevnou dĺžkou sa spolu s bufferom nerozšíri. Ak zmenšenie buffera spôsobí, že rozsah pohľadu prestane byť platný, byteLength bude 0.

Základná vlastnosť je v prehliadačoch široko dostupná od júla 2015; podporu bufferov s meniteľnou veľkosťou treba overiť osobitne. V príklade znamená tretí argument Uint16Array 3 prvky, nie 3 bajty: pohľad pokrýva 6 bajtov v 16-bajtovom buffri.

Príklady

const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);

console.log(view.length);
console.log(view.BYTES_PER_ELEMENT);
console.log(view.byteLength);
console.log(view.byteOffset);
console.log(view.buffer.byteLength);

Výsledok

3
2
6
4
16

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje