Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

String.prototype.split — diviser du texte en tableau

String.prototype.split divise un texte à l’aide d’un séparateur et renvoie un tableau de morceaux. Découvrez le fonctionnement de la limite et des éléments vides, ainsi que la différence entre un séparateur vide et un séparateur omis.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

string.split(separator, limit)

String.prototype.split divise le texte de gauche à droite sans modifier l’original. Un séparateur sous forme de chaîne est recherché littéralement et n’est pas inclus dans le tableau obtenu. Des séparateurs adjacents, ainsi que ceux placés au début ou à la fin, peuvent produire des éléments vides.

Si separator est omis ou vaut undefined, la méthode renvoie un tableau contenant la chaîne entière, sauf si la limite vaut zéro. En l’absence de correspondance, la chaîne entière est également conservée. Le séparateur "" divise la chaîne en unités de code UTF-16, qui ne correspondent pas nécessairement à des caractères complets tels que les perçoit l’utilisateur ; "".split("") renvoie [].

L’argument facultatif limit plafonne le nombre d’éléments, et non le nombre de divisions : le texte restant est supprimé. Sa valeur par défaut est 2 ** 32 - 1 ; toute valeur fournie est convertie à l’aide de ToUint32. Une valeur limit de 0 produit [].

Le séparateur peut aussi être un objet doté d’une méthode [Symbol.split], comme un RegExp. Dans ce cas, split transmet à cette méthode le récepteur et la limite, puis renvoie directement son résultat ; une méthode personnalisée peut modifier les règles décrites ci-dessus. Appeler String.prototype.split avec null ou undefined comme récepteur déclenche une TypeError.

Exemples

const text = "red,,blue,";
console.log(JSON.stringify(text.split(",")));
console.log(JSON.stringify(text.split(",", 2)));
console.log(JSON.stringify(text.split()));
console.log(JSON.stringify("".split("")));

Résultat

["red","","blue",""]
["red",""]
["red,,blue,"]
[]

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources