Constructeur Uint8Array()

Syntaxe

new Uint8Array(); // apparu avec ES2017
new Uint8Array(longueur);
new Uint8Array(tableauType);
new Uint8Array(objet);

new Uint8Array(buffer);
new Uint8Array(buffer, decalageOctets);
new Uint8Array(buffer, decalageOctets, longueur);

Paramtres

longueur

Lorsque le constructeur est invoqu avec un argument indiquant une longueur, un tampon de mmoire interne tabul est cr, dont la taille en octets est longueur multiplie par BYTES_PER_ELEMENT, et qui contient des zros.

tableauType

Lorsque le constructeur est invoqu avec un tableau typ comme argument (tout tableau typ en dehors des tableaux typs bigint tel que Int32Array), ce tableau typ est copi dans un nouveau tableau typ. Chaque valeur de tableauType est convertie dans le type correspondant au constructeur avant d'tre copie dans le nouveau tableau. La longueur du nouveau tableau typ sera la mme que celle de tableauType.

objet

Lorsque le constructeur est appel avec un objet comme argument, le nouveau tableau typ est cr avec la mthode TypedArray.from().

buffer, decalageOctets, longueur

Lorsque le constructeur est invoqu avec un tampon, ventuellement un dcalage en octets et une longueur, une nouvelle vue en tableau typ est cre qui reflte l'objet ArrayBuffer correspondant. Les paramtres decalageOctets et longueur indique l'intervalle de mmoire expos la vue. Si ces deux paramtres sont absents, c'est l'intgralit du tampon qui est vue. Si la longueur est absente, c'est la portion du tampon, aprs le dcalage indiqu, qui est vue.

Exemples

Diffrentes faons de construire un objet Uint8Array

// Construction  partir d'une longueur
let uint8 = new Uint8Array(2);
uint8[0] = 42;
console.log(uint8[0]); // 42
console.log(uint8.length); // 2
console.log(uint8.BYTES_PER_ELEMENT); // 1

// Construction  partir d'un tableau
let arr = new Uint8Array([21, 31]);
console.log(arr[1]); // 31

// Construction  partir d'un tableau typ
let x = new Uint8Array([21, 31]);
let y = new Uint8Array(x);
console.log(y[0]); // 21

// Construction  partir d'un ArrayBuffer
let buffer = new ArrayBuffer(8);
let z = new Uint8Array(buffer, 1, 4);

// Construction  partir d'un itrable
let iterable = (function* () {
  yield* [1, 2, 3];
})();
let uint8 = new Uint8Array(iterable);
// Uint8Array[1, 2, 3]

Spcifications

Compatibilit des navigateurs

Notes de compatibilit

partir d'ECMAScript 2015 (ES6), Uint8Array doit tre utilis avec l'oprateur new. Appeler un constructeur Uint8Array comme une fonction, sans new, provoquera une exception TypeError.

let dv = Uint8Array([1, 2, 3]);
// TypeError: calling a builtin Uint8Array constructor
// without new is forbidden

let dv = new Uint8Array([1, 2, 3]);

Voir aussi

• Une prothse d'mulation (polyfill) pour Uint8ClampedArray avec core-js
• Les tableaux typs en JavaScript
• ArrayBuffer
• DataView