CKTIS / JavaScript
TypedArray.byteLength — délka pohledu v bajtech
Vlastnost byteLength udává počet bajtů, které pokrývá pohled na typované pole, nikoli počet jeho prvků ani velikost celého bufferu. Čte se z instance a nemá setter.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
typedArray.byteLengthTypedArray.byteLength zde označuje vlastnost instance, formálně nazvanou TypedArray.prototype.byteLength. Čte se jako typedArray.byteLength, bez závorek. TypedArray není globální konstruktor; použijte konkrétní typ, například Uint16Array. Vlastnost nemá setter: přiřazení hodnoty její velikost pohledu nezmění.
length počítá prvky, zatímco byteLength počítá bajty: typedArray.byteLength === typedArray.length * typedArray.BYTES_PER_ELEMENT. Naproti tomu typedArray.buffer.byteLength popisuje celý buffer a byteOffset udává začátek pohledu v bajtech. Pohled může pokrývat jen část bufferu; jeho byteLength není měřítkem celkové spotřeby paměti objektu.
U bufferu s proměnlivou velikostí se byteLength pohledu, který sleduje délku, může měnit. Pohled s pevnou délkou se spolu s bufferem nerozšiřuje. Pokud zmenšení bufferu způsobí, že rozsah pohledu přestane být platný, byteLength bude 0.
Základní vlastnost je v prohlížečích široce dostupná od července 2015; podporu bufferů s proměnlivou velikostí je třeba ověřit zvlášť. V příkladu znamená třetí argument Uint16Array 3 prvky, nikoli 3 bajty: pohled pokrývá 6 bajtů v 16bajtovém bufferu.
Pří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ýsledek
3 2 6 4 16
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.