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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.