Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Uint8Array — pogled na bajte brez predznaka

Uint8Array izpostavlja podatke medpomnilnika kot 8-bitna cela števila brez predznaka v razponu od 0 do 255. Omogoča ustvarjanje in kopiranje bajtov ali skupno rabo pomnilnika prek pogledov; zapisi zunaj razpona se zavrtijo nazaj, namesto da bi se omejili.

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

Sintaksa

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

Uint8Array je tipizirana matrika: pogled na medpomnilnik, katerega vsak element zavzame en bajt in se pri branju vrne kot vrednost Number od 0 do 255. To ni običajna matrika Array. Lastnost length podaja število elementov, byteLength velikost pogleda v bajtih, buffer pa izpostavlja osnovni medpomnilnik.

new Uint8Array(length) ustvari medpomnilnik, zapolnjen z ničlami. new Uint8Array(values) kopira vrednosti iz iterabilnega ali matriki podobnega objekta. new Uint8Array(buffer, byteOffset, length) brez kopiranja ustvari pogled na obstoječi medpomnilnik; byteOffset je odmik v bajtih, length pa podaja število elementov. Konstruktor zahteva new.

Pri prirejanju se končna števila zaokrožijo proti nič in nato zmanjšajo po modulu 256: 256 postane 0, -1 pa 255. Vrednost NaN ter pozitivna in negativna neskončnost se pretvorijo v 0. To ni preverjanje razpona niti omejevanje kot pri Uint8ClampedArray; neveljavne podatke preverite pred zapisom.

subarray() ustvari pogled, ki si deli pomnilnik, medtem ko slice() ustvari neodvisno kopijo. V primeru sprememba view[0] spremeni tudi bytes[1], copy pa ostane nespremenjen. Ta vnos obravnava osnovne operacije ECMAScript, ne novejših metod kodiranja. Sama specifikacija ne dokazuje združljivosti z določenim brskalnikom; tega ne dokazuje niti prisotnost Node 24 v repozitoriju.

Primeri

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

Rezultat

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri