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

CKTIS / JavaScript

Typovaná pole: počet prvků, bajty pohledu a bajty bufferu

Rozlišujte objekt bufferu (`.buffer`), počet prvků (`.length`), velikost pohledu v bajtech (`.byteLength`) a aktuální velikost celého bufferu (`.buffer.byteLength`).

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

const buffer = new ArrayBuffer(byteCount);
const view = new Uint16Array(buffer, byteOffset, elementCount);
view.buffer       // backing buffer object
view.length       // element count in the view
view.byteLength   // byte count in the view
buffer.byteLength // current byte count of the entire buffer

view.buffer vrací tentýž objekt bufferu, aniž by kopíroval data: ArrayBuffer, nebo u pohledu na sdílenou paměť SharedArrayBuffer. view.length udává počet prvků, zatímco view.byteLength počet bajtů pohledu: view.length * view.BYTES_PER_ELEMENT. view.buffer.byteLength udává aktuální velikost celého bufferu v bajtech, nikoli jeho maximum. SharedArrayBuffer má vlastní getter byteLength. Jde o vlastnosti pouze pro čtení, ne o metody.

new Uint16Array(n) vyhradí paměť pro n prvků. Naproti tomu new Uint16Array(buffer, byteOffset, length) vytvoří pohled bez kopírování: posun je v bajtech a délka v prvcích. Nesprávně zarovnaný posun nebo rozsah přesahující hranice bufferu vyvolá RangeError. Má-li příjemce dostat jen data pohledu, předejte kopii jeho rozsahu bajtů, nikoli view.buffer, který zpřístupňuje i bajty mimo pohled.

Pokud lze měnit velikost ArrayBuffer (ECMAScript 2024), po vynechání length pohled zahrnuje všechny celé prvky, které se vejdou od jeho posunu po konec bufferu. Výslovně zadané length rozsah pohledu zafixuje. Zmenšením bufferu se může pohled dostat mimo jeho hranice: view.length a view.byteLength pak vracejí 0. Opětovné zvětšení může rozsah znovu zplatnit. Před použitím ověřte podporu změny velikosti v cílovém prostředí.

Přenos ArrayBuffer na webu může odpojit původní buffer od jeho dat. view.buffer stále vrací tentýž objekt, ale buffer.byteLength, view.length a view.byteLength vracejí 0. Samotná nula není důkazem odpojení: buffer nebo pohled může být prostě prázdný.

Příklady

{
  const buffer = new ArrayBuffer(16);
  const view = new Uint16Array(buffer, 4, 3);
  console.log(`${view.buffer === buffer} | ${view.length} | ${view.byteLength} | ${buffer.byteLength}`);
}

Výsledek

true | 3 | 6 | 16

`true | 3 | 6 | 16` potvrzuje, že pohled používá tentýž buffer: od bajtového posunu 4 zabírá 3 prvky po 2 bajtech v bufferu o velikosti 16 bajtů.

Související lekce

  • JavaScript · Lekce 5 · Pokročilá · Verze: 4

Zdroje