Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Uint8Array — pohled na bajty bez znaménka

Uint8Array zpřístupňuje data bufferu jako 8bitová celá čísla bez znaménka v rozsahu 0 až 255. Umožňuje vytvářet a kopírovat bajty nebo sdílet paměť prostřednictvím pohledů; zápisy mimo rozsah se převinou, místo aby se omezily na krajní hodnotu.

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

Syntaxe

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

Uint8Array je typované pole: pohled na buffer, jehož každý prvek zabírá jeden bajt a při čtení má podobu hodnoty Number v rozsahu 0 až 255. Není to běžné Array. Vlastnost length udává počet prvků, byteLength velikost pohledu v bajtech a buffer zpřístupňuje podkladový buffer.

new Uint8Array(length) vytvoří buffer vyplněný nulami. new Uint8Array(values) zkopíruje hodnoty z iterovatelného objektu nebo objektu podobného poli. new Uint8Array(buffer, byteOffset, length) vytvoří pohled na existující buffer bez kopírování; byteOffset je posun v bajtech a length udává počet prvků. Konstruktor vyžaduje new.

Při přiřazení se konečná čísla zkrátí směrem k nule a poté se převedou modulo 256: 256 se změní na 0 a -1 na 255. NaN a nekonečna se změní na 0. Nejde ani o kontrolu rozsahu, ani o omezení hodnot jako u Uint8ClampedArray; neplatné vstupy před zápisem ověřte.

subarray() vytvoří pohled sdílející paměť, zatímco slice() vytvoří nezávislou kopii. V příkladu změna view[0] změní také bytes[1], ale copy zůstane beze změny. Tento záznam popisuje základní operace ECMAScriptu, nikoli novější metody kódování. Samotná specifikace nedokládá kompatibilitu s konkrétním prohlížečem; nedokládá ji ani přítomnost Node 24 v repozitáři.

Pří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ýsledek

0,42,0,255
255,0
4:4

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje