Constructeur Uint8ClampedArray()

Syntaxe

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

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

Paramètres

longueur

Lorsque le constructeur est invoqué avec un argument indiquant une longueur, un tampon de mémoire interne tabulé est créé, dont la taille en octets est longueur multipliée par BYTES_PER_ELEMENT, et qui contient des zéros.

tableauType

Lorsque le constructeur est invoqué avec un tableau typé comme argument (tout tableau typé en dehors des tableaux typés 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 copiée dans le nouveau tableau. La longueur du nouveau tableau typé sera la même que celle de tableauType.

objet

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

buffer, decalageOctets, longueur

Lorsque le constructeur est invoqué avec un tampon, éventuellement un décalage en octets et une longueur, une nouvelle vue en tableau typé est créée qui reflète l'objet ArrayBuffer correspondant. Les paramètres decalageOctets et longueur indique l'intervalle de mémoire exposé à la vue. Si ces deux paramètres sont absents, c'est l'intégralité du tampon qui est vue. Si la longueur est absente, c'est la portion du tampon, après le décalage indiqué, qui est vue.

Exemples

Différentes façons de créer un objet Uint8ClampedArray

// À partir d'une longueur
let uintc8 = new Uint8ClampedArray(2);
uintc8[0] = 42;
uintc8[1] = 1337;
console.log(uintc8[0]); // 42
console.log(uintc8[1]); // 255 (écrétée)
console.log(uintc8.length); // 2
console.log(uintc8.BYTES_PER_ELEMENT); // 1

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

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

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

// À partir d'un itérable
let iterable = (function* () {
  yield* [1, 2, 3];
})();
let uintc8 = new Uint8ClampedArray(iterable);
// Uint8ClampedArray[1, 2, 3]

Spécifications

Compatibilité des navigateurs

Notes de compatibilité

À partir d'ECMAScript 2015, le constructeur Uint8ClampedArray doit être appelé avec l'opérateur new. Invoquer le constructeur Uint8ClampedArray comme une fonction, sans new, déclenchera une exception TypeError.

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

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

Voir aussi

• Une prothèse d'émulation (polyfill) pour Uint8ClampedArray avec core-js
• Les tableaux typés en JavaScript
• ArrayBuffer
• DataView