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

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

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

Zdroje