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