Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

TypedArray: veľkosti, indexovanie, pohľady a kópie

Spoznajte rozdiel medzi počtom prvkov a počtom bajtov v TypedArray. Zistite, ako buffer a byteOffset opisujú pohľad a prečo subarray() zdieľa údaje, zatiaľ čo slice() vytvára nezávislú kópiu.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const view = new Uint16Array(buffer, byteOffset, length);
view.length; view.byteLength; view.buffer; view.byteOffset;
view[index]; view[index] = value;
view.subarray(begin, end);
view.slice(start, end);

TypedArray je spoločné rozhranie typovaných pohľadov na binárne údaje, nie globálne dostupný konštruktor. Použite konkrétny typ, napríklad Uint16Array. Tieto API patria do ECMAScriptu a nevyžadujú DOM. Tu TypedArray.length, TypedArray.byteLength, TypedArray.buffer a TypedArray.byteOffset označujú vlastnosti inštancie, napríklad view.length, nie statické vlastnosti.

length počíta prvky, byteLength bajty pohľadu, buffer odkazuje na celý podkladový ArrayBuffer alebo SharedArrayBuffer a byteOffset určuje začiatok pohľadu v bajtoch vzhľadom na buffer. Pre platný pohľad platí byteLength === length * BYTES_PER_ELEMENT. Pohľad môže zahŕňať iba časť buffera. V new Uint16Array(buffer, byteOffset, length) musí byť offset násobkom 2, zatiaľ čo length stále počíta prvky. Tieto vlastnosti sú iba na čítanie; zmena veľkosti buffera však môže zmeniť uvádzané veľkosti a pohľad mimo rozsahu uvádza nulové veľkosti aj offset.

TypedArray.indexing označuje syntax view[index], nie metódu. Indexy začínajú od nuly a určujú prvky vzhľadom na začiatok pohľadu. Pri priradení sa hodnota prevedie na typ prvku. Čítanie mimo rozsahu vráti undefined; zápis mimo rozsahu pohľad nezväčší a hodnotu neuloží. view[-1] nečíta posledný prvok.

TypedArray.prototype.subarray(begin, end) vytvára nový pohľad zdieľajúci buffer: zmeny prekrývajúcich sa prvkov sú viditeľné v oboch pohľadoch. TypedArray.prototype.slice(start, end) skopíruje vybrané prvky do nezávislého buffera. Obe metódy určujú hranice v prvkoch, začiatok zahrnú a koniec vylúčia; záporné hranice sa počítajú od konca a vynechaný koniec znamená koniec pohľadu. Tieto pravidlá opisujú bežné vstavané typy; vlastné podtriedy môžu tvorbu výsledkov zmeniť pomocou Symbol.species.

Príklady

const buffer = new ArrayBuffer(12);
const view = new Uint16Array(buffer, 2, 4);
view.set([10, 20, 30, 40]);
const shared = view.subarray(1, 3);
const copied = view.slice(1, 3);
shared[0] = 99;
console.log(view.length, view.byteLength, view.byteOffset, buffer.byteLength);
console.log(shared.byteOffset, shared.buffer === view.buffer, copied.buffer === view.buffer);
console.log(view.join(','));
console.log(shared.join(','));
console.log(copied.join(','));
view[4] = 50;
console.log(view[4], view.length);

Výsledok

4 8 2 12
4 true false
10,99,30,40
99,30
20,30
undefined 4

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje