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

CKTIS / JavaScript

Uint16Array — типизиран масив от 16 бита без знак

Uint16Array е типизиран изглед към буфер, който съхранява цели числа от 0 до 65535, с по 2 байта на елемент. Научете как се преобразуват стойностите и каква е разликата между копирането на данни и споделянето на изглед.

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

Синтаксис

new Uint16Array(length)
new Uint16Array(iterableOrArrayLike)
new Uint16Array(typedArray)
new Uint16Array(buffer, byteOffset?, length?)

Uint16Array е вграден типизиран масив на ECMAScript, а не обикновен Array. Всеки елемент заема 2 байта и при прочит се връща като Number от 0 до 65535. length показва броя на елементите, byteLength — броя байтове на изгледа, а Uint16Array.BYTES_PER_ELEMENT е 2.

Конструкторът изисква new. При числов аргумент конструкторът прилага ToIndex, за да определи броя на елементите с начална стойност нула. Например new Uint16Array(3.9) създава три елемента, а new Uint16Array(-1) хвърля изключение RangeError. Колекция предоставя стойности за копиране. Вариантът с ArrayBuffer създава изглед без копиране: byteOffset се измерва в байтове и трябва да е кратно на 2, а незадължителният length брои елементи, не байтове.

При запис стойностите се преобразуват, вместо да се проверява дали са в диапазона: крайните стойности Number се отрязват към нулата, след което се редуцират по модул 65536. Така 65536 става 0, -1 става 65535, а 3.9 става 3. NaN и безкрайностите стават 0; стойностите BigInt причиняват TypeError. Това не е ограничаване в диапазона.

subarray() споделя хранилището с оригинала, докато slice() копира данните. Примерът показва преобразуването и промяната на оригинала чрез изглед. Редът на байтовете е според конкретната реализация; използвайте DataView за двоичен формат с изрично зададен ред на байтовете.

Примери

const values = new Uint16Array([65535, 65536, -1, 3.9]);
const view = values.subarray(1, 3);
view[0] = 42;
console.log(values.join(","));
console.log(`${values.length} ${values.byteLength} ${Uint16Array.BYTES_PER_ELEMENT}`);

Резултат

65535,42,65535,3
4 8 2

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

Източници