Float16Array

Baseline 2025

Newly available

Depuis April 2025, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

Le tableau typé Float16Array représente un tableau de nombres à virgule flottante sur 16 bits dans l'ordre des octets de la plateforme. Si vous avez besoin de contrôler l'ordre des octets, utilisez plutôt DataView. Le contenu est initialisé à 0 sauf si des données d'initialisation sont explicitement fournies. Une fois établi, vous pouvez référencer les éléments du tableau en utilisant les méthodes de l'objet ou la syntaxe standard d'index de tableau (c'est-à-dire la notation entre crochets).

Float16Array est une sous-classe de la classe cachée de TypedArray.

Note : La prise en charge de Float16 n'est pas universelle, que ce soit dans l'API JavaScript ou l'architecture CPU sous-jacente. Son utilisation peut entraîner des ralentissements des performances sur certaines plateformes. Elle est destinée à l'interaction avec des systèmes hautement optimisés et sensibles aux performances comme les canevas à base de float ^(angl.), WebGPU, WebGL et les modèles d'apprentissage profond, y compris stable diffusion ^(angl.).

Constructeur

Float16Array(): Crée un nouvel objet Float16Array.

Propriétés statiques

Hérite aussi des propriétés statiques de son parent TypedArray.

Float16Array.BYTES_PER_ELEMENT: Retourne une valeur numérique correspondant à la taille d'un élément. 2 dans le cas de Float16Array.

Méthodes statiques

Hérite des méthodes statiques de son parent TypedArray.

Propriétés d'instance

Hérite aussi des propriétés d'instance de son parent TypedArray.

Ces propriétés sont définies sur Float16Array.prototype et partagées par toutes les instances de Float16Array.

Float16Array.prototype.BYTES_PER_ELEMENT: Retourne une valeur numérique correspondant à la taille d'un élément. 2 dans le cas d'un Float16Array.
Float16Array.prototype.constructor: La fonction constructeur qui a créé l'objet instance. Pour les instances de Float16Array, la valeur initiale est le constructeur Float16Array.

// À partir d'une longueur
const float16 = new Float16Array(2);
float16[0] = 42;
console.log(float16[0]); // 42
console.log(float16.length); // 2
console.log(float16.BYTES_PER_ELEMENT); // 2

// À partir d'un tableau
const x = new Float16Array([21, 31]);
console.log(x[1]); // 31

// À partir d'un autre TypedArray
const y = new Float16Array(x);
console.log(y[0]); // 21

// À partir d'un ArrayBuffer
const tampon = new ArrayBuffer(32);
const z = new Float16Array(tampon, 4, 4);
console.log(z.byteOffset); // 4

// À partir d'un itérable
const iterable = (function* () {
  yield* [1, 2, 3];
})();
const float16DepuisUnIterable = new Float16Array(iterable);
console.log(float16DepuisUnIterable);
// Float16Array [1, 2, 3]