CKTIS / JavaScript
TypedArray.byteLength — duljina pogleda u bajtovima
Svojstvo byteLength navodi koliko bajtova obuhvaća pogled tipiziranog polja, a ne broj elemenata ni veličinu cijelog međuspremnika. Čita se s instance i nema setter.
Verzija: 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.byteLengthTypedArray.byteLength ovdje označava svojstvo instance, formalno nazvano TypedArray.prototype.byteLength. Čita se kao typedArray.byteLength, bez zagrada. TypedArray nije globalni konstruktor; upotrijebite konkretan tip, primjerice Uint16Array. Svojstvo nema setter: dodjeljivanje vrijednosti ne mijenja veličinu pogleda.
length broji elemente, dok byteLength broji bajtove: typedArray.byteLength === typedArray.length * typedArray.BYTES_PER_ELEMENT. Nasuprot tome, typedArray.buffer.byteLength opisuje cijeli međuspremnik, a byteOffset označava početak pogleda u bajtovima. Pogled može obuhvaćati samo dio međuspremnika; njegov byteLength nije mjera ukupne potrošnje memorije objekta.
Kod međuspremnika promjenjive veličine, byteLength pogleda koji prati duljinu može se mijenjati. Pogled fiksne duljine ne širi se zajedno s međuspremnikom. Ako se smanjenjem međuspremnika raspon pogleda učini nevažećim, byteLength postaje 0.
Osnovno je svojstvo široko dostupno u preglednicima od srpnja 2015.; podršku za međuspremnike promjenjive veličine potrebno je provjeriti zasebno. U primjeru treći argument Uint16Array označava 3 elementa, a ne 3 bajta: pogled obuhvaća 6 bajtova unutar međuspremnika od 16 bajtova.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.