База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Uint8Array — изглед към байтове без знак

Uint8Array предоставя данните от буфер като 8-битови цели числа без знак със стойности от 0 до 255. Позволява създаване и копиране на байтове или споделяне на памет чрез изгледи; записите извън диапазона се завъртат обратно в него, вместо да се ограничават.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

Uint8Array е типизиран масив: изглед към буфер, чиито елементи заемат по един байт и при прочитане се връщат като стойности Number от 0 до 255. Това не е обикновен Array. Свойството length посочва броя на елементите, byteLength — размера на изгледа в байтове, а buffer предоставя достъп до основния буфер.

new Uint8Array(length) създава буфер, запълнен с нули. new Uint8Array(values) копира стойности от итерируем обект или обект, подобен на масив. new Uint8Array(buffer, byteOffset, length) създава изглед към съществуващ буфер, без да го копира; byteOffset е отместване в байтове, а length посочва броя на елементите. Конструкторът изисква new.

При присвояване крайните числа се отрязват към нулата и след това се свеждат по модул 256: 256 става 0, а -1 става 255. NaN и безкрайностите стават 0. Това не е проверка на диапазона, нито ограничаване като при Uint8ClampedArray; проверявайте невалидните данни, преди да ги запишете.

subarray() създава изглед, който споделя паметта, докато slice() създава независимо копие. В примера промяната на view[0] променя и bytes[1], но не променя copy. Този запис обхваща основните операции на ECMAScript, а не по-новите методи за кодиране. Самата спецификация не доказва съвместимост с конкретен браузър; наличието на Node 24 в хранилище също не я доказва.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници