TypedArray.prototype.join()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2016.

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.

Dans cet article

Exemple interactif

const uint8 = new Uint8Array([10, 20, 30, 40, 50]);

console.log(uint8.join());
// Expected output: "10,20,30,40,50"

console.log(uint8.join(""));
// Expected output: "1020304050"

console.log(uint8.join("-"));
// Expected output: "10-20-30-40-50"

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

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.

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 17 févr. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu