TypedArray.prototype.join()

La méthode join() fusionne l'ensemble des éléments d'un tableau en une chaîne de caractères. Cette méthode utilise le même algorithme que Array.prototype.join(). Dans le reste de cet article TypedArray fait référence à l'un des types de tableaux typés.

Syntaxe

typedarray.join([séparateur = ',']);

Paramètres

séparateur

Paramètre optionnel qui définit la chaîne de caractères à utiliser pour séparer chaque élément. Si nécessaire, le séparateur sera converti en une chaîne de caractère. La valeur par défaut du paramètre est une virgule (",").

Valeur de retour

Une chaîne de caractères formée par la concaténation des différents éléments du tableau typé.

Exemples

var uint8 = new Uint8Array([1,2,3]);
uint8.join();      // '1,2,3'
uint8.join(' / '); // '1 / 2 / 3'
uint8.join('');    // '123'

Prothèse d'émulation (polyfill)

Il n'existe pas d'objet global TypedArray, il faut donc ajouter une prothèse correspondant à chaque type de tableau typé.

// https://tc39.github.io/ecma262/#sec-%typedarray%.prototype.join
if (!Uint8Array.prototype.join) {
  Object.defineProperty(Uint8Array.prototype, 'join', {
    value: Array.prototype.join
  });
}

Mieux vaut ne pas ajouter de prothèses pour TypedArray.prototype si le moteur JavaScript ne prend pas en charge Object.defineProperty() car on ne peut pas les rendre non-énumérables.

Spécifications

Spécification État Commentaires
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'TypedArray.prototype.join' dans cette spécification.
Standard Définition initiale.
ECMAScript (ECMA-262)
La définition de 'TypedArray.prototype.join' dans cette spécification.
Standard évolutif  

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi