TypedArray.prototype.byteLength

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

La propriété byteLength est un accesseur qui représente la longueur, exprimée en octets, du tableau typé à partir du début de l'ArrayBuffer correspondant.

Exemple interactif

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer, 2);

console.log(uint8.byteLength);
// Expected output: 6

Syntaxe

typedarray.byteLength;

La propriété byteLength est un accesseur dont le mutateur correspondant vaut undefined, ce qui signifie qu'elle n'est accessible qu'en lecture. La valeur de la propriété est déterminée lors de la construction du TypedArray et ne peut pas être modifiée. Si l'objet TypedArray n'utilise pas de byteOffset ou une length, ce sera la propriété length de l'ArrayBuffer référencé par le tableau qui sera renvoyée. TypedArray est l'un des objets TypedArray.

Exemples

var tampon = new ArrayBuffer(8);

var uint8 = new Uint8Array(tampon);
uint8.byteLength; // 8 (correspond au byteLength du tampon correspondant)

var uint8 = new Uint8Array(tampon, 1, 5);
uint8.byteLength; // 5 (correspond à la longueur spécifiée dans le constructeur)

var uint8 = new Uint8Array(tampon, 2);
uint8.byteLength; // 6 (en raison du décalage utilisé pour la construction du Uint8Array)