Constructeur Float32Array()
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.
Le constructeur Float32Array() permet de créer un nouveau tableau typé Float32Array dont les éléments sont des nombres flottants représentés sur 32 bits (ce qui correspond au type de données float du langage C), utilisant le boutisme de la plateforme. S'il est nécessaire de contrôler l'ordre des octets, on utilisera un objet DataView à la place. Lors de la construction, les éléments du tableau sont initialisés avec la valeur 0. Une fois le tableau construit, on peut faire référence aux éléments du tableau à l'aide des méthodes de l'objet ou en utilisant la notation avec les crochets et l'indice voulu.
Syntaxe
new Float32Array(); // apparu avec ES2017
new Float32Array(longueur);
new Float32Array(tableauType);
new Float32Array(object);
new Float32Array(buffer);
new Float32Array(buffer, decalageOctets);
new Float32Array(buffer, decalageOctets, longueur);
Paramètres
longueur-
Lorsque le constructeur est appelé avec un argument
longueur, un tableau interne de tampon de mémoire est créé avec une taille en octets delongueurmultipliée parBYTES_PER_ELEMENTet dont les éléments sont des zéros. tableauType-
Lorsque le constructeur est appelé avec un argument
tableauType, qui peut être un tableau typé de n'importe quel type nonbigint(commeInt32Array),tableauTypeest copié dans un nouveau tableau typé et chaque valeur detableauTypeest convertie dans le type correspondant au constructeur avant d'être copiée dans le nouveau tableau. La longueur du nouveau tableau typé est égale à celle de l'argumenttableauType. object-
Lorsque le constructeur est appelé avec un argument objet quelconque, un nouveau tableau typé est créé, de la même façon qu'avec un appel à la méthode
TypedArray.from(). buffer,decalageOctets,longueur-
Lorsqu'il est appelé avec un argument
buffer, et éventuellement des argumentsdecalageOctetsetlongueur, le constructeur crée une nouvelle vue sous la forme d'un tableau typé qui porte sur l'objetArrayBufferdonné par le paramètrebuffer. Les paramètresdecalageOctetsetlongueurindiquent l'intervalle de mémoire exposé à la vue formée par le tableau typé. Si ces deux derniers paramètres sont absents, c'est l'ensemble debufferqui sera vu ; si seullongueurest absent, c'est toutbufferqui sera vu à partir dedecalageOctets.
Exemples
Plusieurs façons de créer un objet Float32Array
// À partir d'une longueur
let float32 = new Float32Array(2);
float32[0] = 42;
console.log(float32[0]); // 42
console.log(float32.length); // 2
console.log(float32.BYTES_PER_ELEMENT); // 4
// À partir d'un tableau
const arr = new Float32Array([21, 31]);
console.log(arr[1]); // 31
// À partir d'un autre tableau typé
const x = new Float32Array([21, 31]);
const y = new Float32Array(x);
console.log(y[0]); // 21
// À partir d'un ArrayBuffer
const buffer = new ArrayBuffer(16);
const z = new Float32Array(buffer, 0, 4);
// À partir d'un itérable
const iterable = (function* () {
yield* [1, 2, 3];
})();
const float32 = new Float32Array(iterable);
// Float32Array[1, 2, 3]
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-typedarray-constructors |
Compatibilité des navigateurs
Notes de compatibilité
À partir d'ECMAScript 2015, le constructeur de Float32Array doit être appelé avec l'opérateur new. Utiliser le constructeur Float32Array() comme une fonction, c'est-à-dire sans le mot-clé new, déclenchera désormais une exception TypeError.
const dv = Float32Array([1, 2, 3]);
// TypeError: calling a builtin Float32Array constructor
// without new is forbidden
const dv = new Float32Array([1, 2, 3]);