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