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

CKTIS / JavaScript

TypedArray: размери, индексиране, изгледи и копия

Научете разликата между броя елементи и броя байтове в TypedArray. Вижте как buffer и byteOffset описват изглед и защо subarray() споделя данните, докато slice() създава независимо копие.

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

Синтаксис

const view = new Uint16Array(buffer, byteOffset, length);
view.length; view.byteLength; view.buffer; view.byteOffset;
view[index]; view[index] = value;
view.subarray(begin, end);
view.slice(start, end);

TypedArray е общият интерфейс за типизирани изгледи към двоични данни, а не глобално достъпен конструктор. Използвайте конкретен тип като Uint16Array. Тези API принадлежат към ECMAScript и не изискват DOM. Тук TypedArray.length, TypedArray.byteLength, TypedArray.buffer и TypedArray.byteOffset означават свойства на екземпляр, например view.length, а не статични свойства.

length брои елементите, byteLength брои байтовете на изгледа, buffer сочи към целия базов ArrayBuffer или SharedArrayBuffer, а byteOffset задава началото на изгледа в байтове спрямо буфера. За валиден изглед е вярно byteLength === length * BYTES_PER_ELEMENT. Изгледът може да обхваща само част от буфера. В new Uint16Array(buffer, byteOffset, length) отместването трябва да е кратно на 2, докато length продължава да брои елементи. Тези свойства са само за четене; промяната на размера на буфера обаче може да промени отчетените размери, а изглед извън границите отчита нулеви размери и отместване.

TypedArray.indexing означава синтаксиса view[index], а не метод. Индексите започват от нула и адресират елементи спрямо началото на изгледа. При присвояване стойността се преобразува към типа на елемента. Четене извън границите връща undefined; запис извън границите нито увеличава изгледа, нито съхранява стойност. view[-1] не прочита последния елемент.

TypedArray.prototype.subarray(begin, end) създава нов изглед, който споделя буфера: промените в припокриващите се елементи се виждат и в двата изгледа. TypedArray.prototype.slice(start, end) копира избраните елементи в независим буфер. И двата метода задават границите в елементи, включват началото и изключват края; отрицателните граници се броят от края, а пропуснат край означава края на изгледа. Тези правила описват обичайните вградени типове; потребителските подкласове могат да променят създаването на резултати чрез Symbol.species.

Примери

const buffer = new ArrayBuffer(12);
const view = new Uint16Array(buffer, 2, 4);
view.set([10, 20, 30, 40]);
const shared = view.subarray(1, 3);
const copied = view.slice(1, 3);
shared[0] = 99;
console.log(view.length, view.byteLength, view.byteOffset, buffer.byteLength);
console.log(shared.byteOffset, shared.buffer === view.buffer, copied.buffer === view.buffer);
console.log(view.join(','));
console.log(shared.join(','));
console.log(copied.join(','));
view[4] = 50;
console.log(view[4], view.length);

Резултат

4 8 2 12
4 true false
10,99,30,40
99,30
20,30
undefined 4

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

Източници