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

CKTIS / JavaScript

TypedArray.byteLength — дължина на изгледа в байтове

Свойството byteLength показва колко байта обхваща изгледът на типизиран масив, а не броя на елементите или размера на целия буфер. Чете се от екземпляр и няма setter.

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

Синтаксис

typedArray.byteLength

TypedArray.byteLength тук обозначава свойството на екземпляра, чието формално име е TypedArray.prototype.byteLength. Чете се като typedArray.byteLength, без скоби. TypedArray не е глобален конструктор; използвайте конкретен тип, например Uint16Array. Свойството няма setter: присвояването на стойност към него не променя размера на изгледа.

length брои елементите, а byteLength — байтовете: typedArray.byteLength === typedArray.length * typedArray.BYTES_PER_ELEMENT. За разлика от тях typedArray.buffer.byteLength описва целия буфер, а byteOffset указва началото на изгледа в байтове. Изгледът може да обхваща само част от буфер; неговият byteLength не измерва общото използване на памет от обекта.

При буфер с променлив размер byteLength на изглед, който следи дължината, може да се променя. Изгледът с фиксирана дължина не се разширява заедно с буфера. Ако намаляването на буфера направи диапазона на изгледа невалиден, byteLength става 0.

Основното свойство е широко достъпно в браузърите от юли 2015 г.; поддръжката на буфери с променлив размер трябва да се проверява отделно. В примера третият аргумент на Uint16Array означава 3 елемента, а не 3 байта: изгледът обхваща 6 байта в буфер с размер 16 байта.

Примери

const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);

console.log(view.length);
console.log(view.BYTES_PER_ELEMENT);
console.log(view.byteLength);
console.log(view.byteOffset);
console.log(view.buffer.byteLength);

Резултат

3
2
6
4
16

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

Източници