★ wanayoo — archive 1999 https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Objets_globaux/TypedArrayNouvelle recherche | Portail wanayoo

Check out Firefox Developer Edition, the first browser built for developers like you. http://mzl.la/112VrtT

mozilla
Vos résultats de recherche

    TypedArray

    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 que longueur (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 exemple Int32Array), le tableauTypé est copié dans un nouveau tableau typé. Chaque valeur du tableauTypé 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éthode TypedArray.from().
    tampon, décalageOctet, longueur
    Lorsque le constructeur est appelé avec un tampon (buffer) ainsi qu'avec les paramètres optionnels décalageOctet et longueur, un nouveau tableau typé est créé comme une vue pour l'objet ArrayBuffer. Les paramètres décalageOctet et longueur permettent 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 du tampon sera considéré. Si longueur est absent, on considèrera l'ensemble de tampon à 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.buffer Lecture seule
    Cette propriété renvoie l'ArrayBuffer qui 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.byteLength Lecture 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.byteOffset Lecture 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.length Lecture 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 TypedArray en 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) ? ? ?

    Notes
    [1] -1 et les autres valeurs similaires ne sont pas considérées comme des propriétés indexées, dès lors, l'accès renvoie la valeur de la propriété du prototype.

    Voir aussi

    Étiquettes et contributeurs liés au document

    Contributeurs ayant participé à cette page : SphinxKnight
    Dernière mise à jour par : SphinxKnight,