Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Float32Array : flottants sur 32 bits

Float32Array stocke les Number comme nombres IEEE 754 sur 32 bits, à raison de 4 octets par élément.

Version : ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntaxe

new Float32Array(); new Float32Array(length); new Float32Array(source); new Float32Array(buffer[, byteOffset[, length]])

new Float32Array(source?, byteOffset?, length?) crée un typed array numérique. La source peut être une longueur, un itérable ou array-like, un autre typed array numérique ou un ArrayBuffer/SharedArrayBuffer ; la forme tampon est une vue sans copie. byteOffset doit être multiple de 4 et BYTES_PER_ELEMENT vaut 4.

À l’affectation, la valeur passe par ToNumber et est arrondie au binary32 représentable le plus proche. Ainsi 0.1 change légèrement et 16777217 devient 16777216 ; NaN, les infinis et le signe de -0 sont pris en charge. Affecter un BigInt ou fournir un typed array BigInt lève TypeError. L’ordre des octets est natif ; utilisez DataView pour un format fixe.

La longueur passe par ToIndex : les fractions sont tronquées vers zéro, NaN/undefined deviennent 0 et -0.5 aussi. Résultat négatif après ToIntegerOrInfinity, infinité, offset mal aligné ou plage hors tampon lève RangeError ; un tampon détaché lève TypeError. Le type est standard depuis ECMAScript 2015.

Exemples

const values = new Float32Array([0.1, 16777217, -0, Infinity]);
console.log(values[0]);
console.log(values[1]);
console.log(Object.is(values[2], -0), values[3]);
console.log(Float32Array.BYTES_PER_ELEMENT, new Float32Array(2.9).length, new Float32Array(-0.5).length);
try { values[0] = 1n; } catch (error) { console.log(error instanceof TypeError); }

Résultat

0.10000000149011612
16777216
true Infinity
4 2 0
true

Sources