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

CKTIS / JavaScript

Uint8ClampedArray — байтове с ограничени стойности

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

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

Синтаксис

new Uint8ClampedArray(length)
new Uint8ClampedArray(values)
new Uint8ClampedArray(buffer)
new Uint8ClampedArray(buffer, byteOffset)
new Uint8ClampedArray(buffer, byteOffset, length)

Uint8ClampedArray е стандартен тип на ECMAScript: изглед към буфер, чиито елементи заемат по един байт и представят беззнакови цели числа от 0 до 255. Прочетените стойности са от тип Number; това не е обикновен масив Array.

При запис се прилага ToUint8Clamp: стойностите под 0 стават 0, а тези над 255 стават 255. Дробните числа се закръгляват до най-близкото цяло число; при точно равенство се закръглява към четното число. Затова 2.5 става 2, а 3.5 става 4. Това се различава от Math.round. NaN става 0, Infinity става 255, а -Infinity става 0. Uint8Array вместо това отрязва дробните части и завърта целите числа по модул 256.

new Uint8ClampedArray(length) създава елементи, запълнени с нули, а new Uint8ClampedArray(values) копира и преобразува стойностите. Формата с buffer създава изглед към съществуващата памет, без копиране; самото създаване на изгледа не преобразува съхранените байтове. Конструкторът изисква new.

Примерът показва ограничаването и закръгляването при създаване и при последващо присвояване. Ограничаването се прилага при запис в елементите, а не при изчисления с числа, прочетени от масива. Това е функция на езика, а не API на браузъра; спецификацията не е таблица за съвместимост на браузърите.

Примери

const values = new Uint8ClampedArray([-20, 2.5, 3.5, 300, NaN]);
values[0] = 260;
console.log(JSON.stringify(Array.from(values)));

Резултат

[255,2,4,255,0]

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

Източници