Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

TypedArray.byteLength — dolžina pogleda v bajtih

Lastnost byteLength pove, koliko bajtov zajema pogled tipizirane tabele, ne pa števila elementov ali velikosti celotnega medpomnilnika. Preberemo jo na primerku in nima nastavljalnika.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

typedArray.byteLength

TypedArray.byteLength se tukaj nanaša na lastnost primerka, formalno poimenovano TypedArray.prototype.byteLength. Preberemo jo kot typedArray.byteLength, brez oklepajev. TypedArray ni globalni konstruktor; uporabite konkretno vrsto, na primer Uint16Array. Lastnost nima nastavljalnika: prirejanje vrednosti ne spremeni velikosti pogleda.

length šteje elemente, byteLength pa bajte: typedArray.byteLength === typedArray.length * typedArray.BYTES_PER_ELEMENT. Nasprotno typedArray.buffer.byteLength opisuje celoten medpomnilnik, byteOffset pa določa začetek pogleda v bajtih. Pogled lahko zajema samo del medpomnilnika; njegov byteLength ne meri skupne porabe pomnilnika objekta.

Pri medpomnilniku s spremenljivo velikostjo se lahko byteLength pogleda, ki spremlja dolžino, spreminja. Pogled s fiksno dolžino se ne razširi skupaj z medpomnilnikom. Če se zaradi zmanjšanja medpomnilnika obseg pogleda razveljavi, je byteLength enak 0.

Osnovna lastnost je v brskalnikih široko podprta od julija 2015; podporo za medpomnilnike s spremenljivo velikostjo je treba preveriti posebej. V primeru tretji argument Uint16Array pomeni 3 elemente, ne 3 bajte: pogled zajema 6 bajtov v 16-bajtnem medpomnilniku.

Primeri

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

console.log(view.length);
console.log(view.BYTES_PER_ELEMENT);
console.log(view.byteLength);
console.log(view.byteOffset);
console.log(view.buffer.byteLength);

Rezultat

3
2
6
4
16

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri