CKTIS / JavaScript
Długość i indeksowanie tablic typowanych
Właściwość `length` podaje liczbę elementów widoku, a nie liczbę bajtów. Indeksy zaczynają się od zera, a zapis poza zakresem nie rozszerza widoku.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
view.length
view[index]
view[index] = value
view.at(index)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)Tablica typowana, np. Uint16Array, jest widokiem na bufor. view.length to odziedziczona właściwość z getterem bez settera: podaje liczbę elementów. view.byteLength podaje liczbę bajtów widoku, a view.buffer.byteLength — całego bufora. Przypisanie do view.length nie zmienia rozmiaru widoku, a w trybie ścisłym zgłasza TypeError.
Indeksy elementów to liczby całkowite od 0 do view.length - 1. view[0] i view["0"] wskazują ten sam element. Klucze "01" i "1.0" są zwykłymi nazwami właściwości, nie indeksami elementów. view[-0] działa jak view[0], lecz view["-0"] zwraca undefined.
Odczyt niepoprawnego indeksu zwraca undefined. Zapis pod taki indeks po udanej konwersji wartości nie zmienia bufora ani nie dodaje elementu, nawet w trybie ścisłym. Konwersja może jednak zgłosić błąd, np. przy zapisie wartości Number do BigInt64Array. Przy poprawnym indeksie wartość jest zapisywana zgodnie z typem elementu. view[-1] nie liczy od końca; w niepustym widoku robi to view.at(-1), zwracając ostatni element.
Jeśli konstruktor otrzyma ArrayBuffer o zmiennym rozmiarze lub SharedArrayBuffer, który można powiększać, pominięcie trzeciego argumentu length (lub przekazanie undefined) tworzy widok, którego długość dostosowuje się do liczby pełnych elementów od byteOffset do aktualnego końca bufora. Dla bufora o stałym rozmiarze takie wywołanie tworzy widok o stałej długości, a liczba bajtów od byteOffset do końca bufora musi być wielokrotnością rozmiaru elementu w bajtach; w przeciwnym razie konstruktor zgłasza RangeError. Jawna długość daje widok o stałej liczbie elementów, dopóki mieści się w buforze. Jeśli zmniejszenie bufora sprawi, że widok wyjdzie poza jego granice, length zwróci 0; po ponownym powiększeniu widok może znów mieścić się w buforze. Odłączenie bufora również daje length === 0. W obu przypadkach odczyty indeksowane zwracają undefined, ale at() zgłasza TypeError.
Przykłady
"use strict";
{
const view = new Uint16Array([10, 20]);
view[1] = 65537;
view[view.length] = 99;
console.log(`${view.length} ${view.byteLength}`);
console.log(`${view[0]} ${view[1]}`);
console.log(`${view[view.length]} ${view[-1]} ${view.at(-1)}`);
}Wynik
2 4 10 1 undefined undefined 1
Dwa elementy `Uint16Array` zajmują cztery bajty. Zapis `65537` daje `1`, bo zostaje 16 najmłodszych bitów. Zapis pod indeksem `2` nie rozszerza widoku; `at(-1)` odczytuje ostatni element.
Powiązane lekcje
- JavaScript · Lekcja 33 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 34 · Zaawansowany · Wersja: 4