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 bufferview.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
- ECMAScript 2024 — get %TypedArray%.prototype.buffer
- ECMAScript 2024 — get %TypedArray%.prototype.length
- ECMAScript 2024 — get %TypedArray%.prototype.byteLength
- ECMAScript 2024 — get ArrayBuffer.prototype.byteLength
- ECMAScript 2024 — get SharedArrayBuffer.prototype.byteLength
- ECMAScript 2024 — InitializeTypedArrayFromArrayBuffer
- ECMAScript 2024 — ArrayBuffer.prototype.resize
- MDN — TypedArray: Behavior when viewing a resizable buffer
- HTML Standard — StructuredSerializeWithTransfer