Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

TypedArray: veličine, indeksiranje, pogledi i kopije

Upoznajte razliku između broja elemenata i broja bajtova u TypedArray. Saznajte kako buffer i byteOffset opisuju pogled te zašto subarray() dijeli podatke, dok slice() stvara neovisnu kopiju.

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

Sintaksa

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 zajedničko sučelje tipiziranih pogleda na binarne podatke, a ne globalno dostupan konstruktor. Upotrijebite konkretan tip kao što je Uint16Array. Ovi API-ji pripadaju ECMAScriptu i ne zahtijevaju DOM. Ovdje TypedArray.length, TypedArray.byteLength, TypedArray.buffer i TypedArray.byteOffset označavaju svojstva instance, primjerice view.length, a ne statička svojstva.

length broji elemente, byteLength broji bajtove pogleda, buffer upućuje na cijeli temeljni ArrayBuffer ili SharedArrayBuffer, a byteOffset određuje početak pogleda u bajtovima u odnosu na međuspremnik. Za valjan pogled vrijedi byteLength === length * BYTES_PER_ELEMENT. Pogled može obuhvaćati samo dio međuspremnika. U new Uint16Array(buffer, byteOffset, length) pomak mora biti višekratnik broja 2, dok length i dalje broji elemente. Ta su svojstva samo za čitanje; promjena veličine međuspremnika ipak može promijeniti prijavljene veličine, a pogled izvan raspona prijavljuje nulte veličine i pomak.

TypedArray.indexing označava sintaksu view[index], a ne metodu. Indeksi počinju od nule i odnose se na elemente u odnosu na početak pogleda. Dodjelom se vrijednost pretvara u tip elementa. Čitanje izvan raspona vraća undefined; pisanje izvan raspona ne povećava pogled niti pohranjuje vrijednost. view[-1] ne čita posljednji element.

TypedArray.prototype.subarray(begin, end) stvara novi pogled koji dijeli međuspremnik: promjene preklapajućih elemenata vidljive su u oba pogleda. TypedArray.prototype.slice(start, end) kopira odabrane elemente u neovisan međuspremnik. Obje metode određuju granice u elementima, uključuju početak i isključuju kraj; negativne se granice računaju od kraja, a izostavljeni kraj znači kraj pogleda. Ova pravila opisuju uobičajene ugrađene tipove; prilagođene podklase mogu promijeniti stvaranje rezultata pomoću Symbol.species.

Primjeri

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);

Rezultat

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori