Résumé
Un objet TypedArray décrit une vue organisée à la façon d'un tableau pour manipuler un tampon (buffer) de données binaires. TypedArray n'est pas une propriété globale, il n'existe pas non plus de constructeur TypedArray. En revanche, plusieurs propriétés globales existent et leurs valeurs permettent de construire des tableaux typés (typed arrays) avec différents types de données. Ceux-ci sont listés ci-après. Les pages suivantes permettent de décrire les propriétés et méthodes qui peuvent être utilisées sur les différents tableaux typés.
Syntaxe
new TypedArray(longueur); new TypedArray(tableauTypé); new TypedArray(objet); new TypedArray(tampon [, décalageEnOctet [, longueur]]); où TypedArray est l'un de : Int8Array(); Uint8Array(); Uint8ClampedArray(); Int16Array(); Uint16Array(); Int32Array(); Uint32Array(); Float32Array(); Float64Array();
Paramètres
- longueur
-
Lorsque le constructeur est appelé avec un argument
longueur, un tableau typé sera créé, contenant autant de zéros quelongueur(par exemple avec une longueur de 3, on aura un tableau dont les trois éléments seront des zéros). - tableauTypé
-
Lorsque le constructeur est appelé avec un argument
tableauTypé, qui peut être un tableau typé de n'importe quel type (par exempleInt32Array), letableauTypéest copié dans un nouveau tableau typé. Chaque valeur dutableauTypéest convertie dans le type correspondant du nouveau tableau. - objet
-
Lorsque le constructeur est invoqué avec un argument
objet, un nouveau tableau typé est créé avec la méthodeTypedArray.from(). - tampon, décalageOctet, longueur
-
Lorsque le constructeur est appelé avec un
tampon(buffer) ainsi qu'avec les paramètres optionnelsdécalageOctetetlongueur, un nouveau tableau typé est créé comme une vue pour l'objetArrayBuffer. Les paramètresdécalageOctetetlongueurpermettent de définir l'intervalle de mémoire du buffer qui est présenté dans la vue qu'est le tableau typé. Si les deux derniers paramètres sont absents, l'ensemble dutamponsera considéré. Silongueurest absent, on considèrera l'ensemble detamponà partir de l'octet décalageOctet.
Description
ECMAScript 6 définit un constructeur %TypedArray% qui est un [[Prototype]] de tous les constructeurs TypedArray. Ce constructeur n'est pas accessible directement. Il n'existe pas de %TypedArray% global ou de propriété TypedArray. Il est uniquement accessible via Object.getPrototypeOf(Int8Array.prototype) ou avec les méthodes semblables. L'ensemble des différents constructeurs TypedArrays hérite de propriétés communes de la fonction %TypedArray%. De plus, tous les prototypes des tableaux typés (TypedArray.prototype) ont %TypedArray%.prototype pour [[Prototype]].
Le constructeur %TypedArray% en tant que tel n'est pas très utile. Toute tentative d'appel ou d'utilisation avec une expression new renverra TypeError, sauf quand il est utilisé par le moteur JavaScript lors de la création de l'objet quand le moteur supporte les sous-classes. À l'heure actuelle, il n'existe pas de tels moteurs, pour cette raison %TypedArray% est uniquement utile dans les fonctions d'émulation (polyfill) our pour les propriétés des différents constructeurs TypedArray.
Accès aux propriétés
Il est possible d'accéder aux éléments du tableau en utilisant la notation usuelle avec les crochets. Cependant, définir ou accéder à des propriétés indexées ne se fera pas avec la chaîne de prototypes, même si l'indice utilisé est en dehors des limites du tableau. Les propriétés indexées seront uniquement basées sur le contenu du ArrayBuffer et ne consulteront pas les propriétés des objets. En revanche, il est toujours possible d'utiliser des propriétés nommées, comme avec les autres objets.
// Définir et accéder du contenu avec la syntaxe usuelle var int16 = new Int16Array(2); int16[0] = 42; console.log(int16[0]); // 42 // Les propriétés indexées sur les prototypes ne sont pas consultées (Fx 25) Int8Array.prototype[20] = "toto"; (new Int8Array(32))[20]; // 0 // y compris en dehors des limites Int8Array.prototype[20] = "toto"; (new Int8Array(8))[20]; // undefined // ou avec des index négatifs Int8Array.prototype[-1] = "toto"; (new Int8Array(8))[-1]; // undefined // Mais il est possible d'utiliser des propriétés nommées (Fx 30) Int8Array.prototype.toto = "truc"; (new Int8Array(32)).toto; // "truc"
Les objets TypedArray
| Type | Taille | Description | Type Web IDL | Type équivalent en C |
Int8Array |
1 | Entier signé en complément à deux sur 8 bits | byte |
int8_t |
Uint8Array |
1 | Entier non signé sur 8 bits | octet |
uint8_t |
Uint8ClampedArray |
1 | Entier non signé sur 8 bits (compris entre 0 et 255) | octet |
uint8_t |
Int16Array |
2 | Entier signé en complément à deux sur 16 bits | short |
int16_t |
Uint16Array |
2 | Entier non signé sur 16 bits | unsigned short |
uint16_t |
Int32Array |
4 | Entier signé en complément à deux sur 32 bits | long |
int32_t |
Uint32Array |
4 | Entier non signé sur 32 bits | unsigned long |
uint32_t |
Float32Array |
4 | Nombre flottant sur 32 bits selon la représentation IEEE | unrestricted float |
float |
Float64Array |
8 | Nombre flottant sur 64 bits selon la représentation IEEE | unrestricted double |
double |
Propriétés
-
TypedArray.BYTES_PER_ELEMENT - Cette propriété renvoie un nombre correspondant à la taille d'un élément du tableau selon le type de tableau utilisé.
- TypedArray.length
- La propriété de longueur, elle vaut 3.
-
TypedArray.name - Cette propriété renvoie la chaîne de caractères correspondant au nom du constructeur (par exemple "Int8Array").
-
TypedArray.prototype - Le prototype des objets TypedArray.
Méthodes
- TypedArray.from()
-
Voir
Array.from(). Cette méthode n'est pas encore implémentée, voir le bug bug 896608. - TypedArray.of()
-
Voir
Array.of(). Cette méthode n'est pas encore implémentée, voir le bug bug 896608.
Prototype TypedArray
Toutes les instances de TypedArrays héritent de TypedArray.prototype.
Propriétés
-
TypedArray.prototype.constructor - Cette propriété renvoie la fonction qui a créé le prototype de l'instance. Elle correspondra à l'une des fonctions par défaut pour le type du tableau typé utilisé.
-
TypedArray.prototype.bufferLecture seule -
Cette propriété renvoie l'
ArrayBufferqui est référencé par le tableau typé. Cette propriété est définie lors de la construction et est donc accessible en lecture seule uniquement. -
TypedArray.prototype.byteLengthLecture seule -
Cette propriété renvoie la longueur (exprimée en octets) du tableau typé, à partir du début de l'
ArrayBuffer. Cette propriété est définie lors de la construction et est donc accessible en lecture seule uniquement. -
TypedArray.prototype.byteOffsetLecture seule -
Cette propriété renvoie le décalage utilisé (exprimé en octets) entre le début du tableau typé et le début du
ArrayBuffer. Cette propriété est définie lors de la construction et est donc accessible en lecture seule uniquement. -
TypedArray.prototype.lengthLecture seule - Cette propriété renvoie le nombre d'éléments contenus dans le tableau typé. Cette propriété est définie lors de la construction et est donc accessible en lecture seule uniquement.
Méthodes
-
TypedArray.prototype.copyWithin() -
Voir
Array.prototype.copyWithin(). -
TypedArray.prototype.move()Non implémenté -
Ancienne version, non-standard, de
TypedArray.prototype.copyWithin(). -
TypedArray.prototype.set() - Cette méthode permet d'enregistrer plusieurs valeurs dans le tableau typé à partir d'un tableau donné.
-
TypedArray.prototype.subarray() -
Cette méthode renvoie un nouvel objet
TypedArrayen fonction d'un indice de début et de fin.
Spécifications
| Spécification | Statut | Commentaires |
|---|---|---|
| Spécification des tableaux typés | Obsolète | Défini comme TypedArray et interface ArrayBufferView avec les différents types de vues des tableaux typés. Cette spécification a été englobée dans ECMAScript 6. |
| ECMAScript 6 (ECMA-262) La définition de 'TypedArray Objects' dans cette spécification. |
Draft | Définition initiale au sein d'un standard ECMA. |
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Support simple | 7.0 | 4.0 (2) | 10 | 11.6 | 5.1 |
| L'accès aux propriétés indexées ne consulte pas le prototype | (Oui) (voir [1]) | 25 (25) | ? | ? | ? |
| Accès aux propriétés nommées | (Oui) | 30 (30) | ? | ? | ? |
| Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Support simple | 4.0 | (Oui) | 4.0 (2) | 10 | 11.6 | 4.2 |
| L'accès aux propriétés indexées ne consulte pas le prototype | ? | (Oui) (voir [1]) | 25.0 (25) | ? | ? | ? |
| Accès aux propriéts nommées | ? | (Oui) | 30.0 (30) | ? | ? | ? |