TypedArray.prototype.join()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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.

Exemple interactif

Syntaxe

js
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

js
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é.

js
// 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

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.join

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi