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

CKTIS / JavaScript

TypedArray: буфер, отместване, размер в байтове и брой елементи

Разграничи целия буфер от диапазона в байтове и броя елементи в изгледа. Виж какво връщат свойствата след промяна на размера или отделяне на буфера.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

view.buffer
view.byteOffset
view.byteLength
view.length

new Uint16Array(buffer)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)

Екземпляр като Uint16Array е изглед към буфер. TypedArray е име на семейство типове, а не глобален конструктор, който може да се извика пряко. Четирите свойства са наследени и имат getter, но нямат setter. Извикването на такъв getter върху обект, който не е типизиран масив, предизвиква TypeError. view.length не е Uint16Array.length, което показва броя на декларираните параметри на конструктора.

view.buffer връща същия базов обект ArrayBuffer или SharedArrayBuffer, а не копие. view.byteOffset показва къде започва изгледът спрямо началото на буфера, а view.byteLength — размера на изгледа, и двете в байтове. view.length брои елементи. Ако и двете прочитания отразяват един и същ размер на изгледа, е в сила view.byteLength === view.length * view.BYTES_PER_ELEMENT. Getter-ите се извикват поотделно: ако друг агент увеличи размера на базовия SharedArrayBuffer между прочитанията, getter-ите на изглед с адаптивна дължина могат да отчетат различни размери и сравнението може да върне false. view.buffer.byteLength измерва целия буфер, а не само изгледа.

В new Uint16Array(buffer, byteOffset, length) вторият аргумент е в байтове, а третият — в елементи. Отместване, което не е подравнено спрямо размера на елемента, или диапазон извън буфера предизвиква RangeError. Записите се виждат през припокриващи се изгледи към същия буфер. Предаването на изглед не скрива останалите байтове: за да предоставиш достъп само до валиден диапазон, копирай байтовете му в отделен буфер.

При буфер с фиксиран размер пропускането на length обхваща остатъка, в който трябва да се побират само цели елементи. При ArrayBuffer с променлив размер или разширяем SharedArrayBuffer пропускането на length или подаването на undefined създава изглед с адаптивна дължина: той брои целите елементи, които се побират от отместването нататък. Изрично подаденият брой елементи фиксира дължината на изгледа.

Намаляването на буфера може да остави изгледа извън границите му, а повторното увеличаване може да го върне в тях. Ако изгледът е извън границите или неговият ArrayBuffer е отделен (например при прехвърляне), трите числови getter-а връщат 0, но buffer продължава да връща същия обект. Валиден празен изглед може да има ненулево отместване. Промяната на размера и разширяването са описани в ECMAScript 2024; провери поддръжката в целевата среда за изпълнение.

Примери

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

  console.log([
    view.buffer === buffer,
    view.byteOffset,
    view.byteLength,
    view.length,
    view.buffer.byteLength,
  ].join(" "));

  view[0] = 513;
  console.log(String(new Uint16Array(buffer)[2]));
}

Резултат

true 4 6 3 16
513

Изгледът започва от байт 4 и обхваща три двубайтови елемента, тоест 6 от 16 байта. Записът на индекс 0 се вижда на индекс 2 в изгледа към целия буфер.

Свързани уроци

  • JavaScript · Урок 2 · Напреднало · Версия: 4

Източници