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

CKTIS / JavaScript

Uint8Array — pohľad na bajty bez znamienka

Uint8Array sprístupňuje údaje buffera ako 8-bitové celé čísla bez znamienka v rozsahu 0 až 255. Umožňuje vytvárať a kopírovať bajty alebo zdieľať pamäť prostredníctvom pohľadov; zápisy mimo rozsahu sa pretočia, namiesto toho, aby sa obmedzili na hraničnú hodnotu.

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

new Uint8Array(length)
new Uint8Array(values)
new Uint8Array(buffer[, byteOffset[, length]])

Uint8Array je typované pole: pohľad na buffer, ktorého každý prvok zaberá jeden bajt a pri čítaní má podobu hodnoty Number v rozsahu 0 až 255. Nie je to obyčajné Array. Vlastnosť length udáva počet prvkov, byteLength veľkosť pohľadu v bajtoch a buffer sprístupňuje podkladový buffer.

new Uint8Array(length) vytvorí buffer vyplnený nulami. new Uint8Array(values) skopíruje hodnoty z iterovateľného objektu alebo objektu podobného poľu. new Uint8Array(buffer, byteOffset, length) vytvorí pohľad na existujúci buffer bez kopírovania; byteOffset je posun v bajtoch a length udáva počet prvkov. Konštruktor vyžaduje new.

Pri priradení sa konečné čísla skrátia smerom k nule a potom sa prevedú modulo 256: 256 sa zmení na 0 a -1 na 255. NaN a nekonečné hodnoty sa zmenia na 0. Nejde ani o kontrolu rozsahu, ani o obmedzovanie hodnôt ako pri Uint8ClampedArray; neplatné vstupy pred zápisom overte.

subarray() vytvorí pohľad zdieľajúci pamäť, zatiaľ čo slice() vytvorí nezávislú kópiu. V príklade zmena view[0] zmení aj bytes[1], ale copy zostane nezmenené. Tento záznam opisuje základné operácie ECMAScriptu, nie novšie metódy kódovania. Samotná špecifikácia nedokladá kompatibilitu s konkrétnym prehliadačom; nedokladá ju ani prítomnosť Node 24 v repozitári.

Príklady

const bytes = new Uint8Array([0, 255, 256, -1]);
const view = bytes.subarray(1, 3);
const copy = bytes.slice(1, 3);
view[0] = 42;
console.log(bytes.join(','));
console.log(copy.join(','));
console.log(bytes.length + ':' + bytes.byteLength);

Výsledok

0,42,0,255
255,0
4: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