Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Tablice typowane: liczba elementów, bajty widoku i bajty bufora

Odróżnij obiekt bufora (`.buffer`), liczbę elementów (`.length`), rozmiar widoku w bajtach (`.byteLength`) i bieżący rozmiar całego bufora (`.buffer.byteLength`).

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

Składnia

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 zwraca ten sam obiekt bufora, bez kopiowania danych. Jest to ArrayBuffer lub, w przypadku widoku na pamięć współdzieloną, SharedArrayBuffer. view.length liczy elementy, a view.byteLength liczy bajty widoku: view.length * view.BYTES_PER_ELEMENT. view.buffer.byteLength to bieżący rozmiar całego bufora w bajtach, a nie jego maksymalny rozmiar. SharedArrayBuffer ma własny getter byteLength. Są to właściwości tylko do odczytu, nie metody.

new Uint16Array(n) przydziela miejsce na n elementów. Natomiast new Uint16Array(buffer, byteOffset, length) tworzy widok bez kopiowania: przesunięcie podaje się w bajtach, a długość w elementach. Niewyrównane przesunięcie lub zakres wykraczający poza bufor powoduje RangeError. Jeśli odbiorca ma dostać tylko dane widoku, przekaż kopię jego zakresu bajtów, a nie view.buffer, który udostępnia też bajty spoza widoku.

W buforze ArrayBuffer o zmiennym rozmiarze (ECMAScript 2024) pominięcie length oznacza, że widok obejmuje tyle pełnych elementów, ile mieści się od przesunięcia do końca bufora. Jawne length ustala zakres widoku. Zmniejszenie bufora może sprawić, że widok znajdzie się poza jego granicami: view.length i view.byteLength zwrócą wtedy 0. Ponowne powiększenie może przywrócić poprawny zakres. Przed użyciem sprawdź obsługę zmiany rozmiaru w docelowym środowisku.

Transfer ArrayBuffer na platformie WWW może odłączyć pierwotny bufor. view.buffer nadal zwraca ten sam obiekt, ale buffer.byteLength, view.length i view.byteLength zwracają 0. Samo zero nie dowodzi odłączenia: bufor lub widok może być po prostu pusty.

Przykłady

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

Wynik

true | 3 | 6 | 16

Wynik `true | 3 | 6 | 16` potwierdza, że widok korzysta z tego samego bufora: od bajtu o przesunięciu 4 obejmuje 3 elementy, po 2 bajty każdy, w buforze o rozmiarze 16 bajtów.

Powiązane lekcje

  • JavaScript · Lekcja 5 · Zaawansowany · Wersja: 4

Źródła