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.byteLengthTypedArray.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.