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

CKTIS / JavaScript

TypedArray.length — брой елементи в изгледа

TypedArray.length показва броя на елементите в типизиран масив, а не броя на байтовете. Свойството се чете от екземпляр, например чрез values.length, и не служи за промяна на размера на изгледа.

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

Синтаксис

typedArray.length

TypedArray.length тук обозначава свойството на екземпляра, документирано като TypedArray.prototype.length. Прочетете го чрез typedArray.length, без скоби за извикване. TypedArray е общата абстракция за конкретни типове като Uint16Array, а не глобален конструктор, който може да се използва директно.

length брои елементите на изгледа. byteLength брои байтовете на този изглед, докато buffer.byteLength описва целия буфер. Всеки елемент на Uint16Array заема 2 байта, затова изглед с length, равна на 3, има byteLength, равна на 6. Изгледът може да обхваща само част от буфера си. В конструктора byteOffset се задава в байтове, а length — в елементи.

Свойството е accessor без setter: присвояването на стойност на length не променя размера на типизиран масив. При буфер с променлив размер обаче length на изглед, който следи дължината, може да се променя заедно с буфера. Ако свиването на буфера направи диапазона на изгледа невалиден, прочитането на свойството връща 0, включително при изглед с фиксирана дължина. Проверявайте поддръжката на буфери с променлив размер отделно; самият достъп до length не доказва такава поддръжка.

Примери

const buffer = new ArrayBuffer(12);
const values = new Uint16Array(buffer, 2, 3);

console.log(values.length);
console.log(values.byteLength);
console.log(buffer.byteLength);

Резултат

3
6
12

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

Източници