La méthode slice() extrait une section d'une chaine de caractères et la retourne comme une nouvelle chaine de caractères. La chaîne de caractères courante n'est pas modifiée.

Syntaxe

chn.slice(indiceDebut[, indiceFin])

Paramètres

indiceDebut
L'indice base 0 auquel commencer l'extraction. Si négatif, il est traité comme (longueurSource + indiceDebut) où longueurSource est la longueur de la chaine de caractères (par exemple, si indiceDebut est -3, il sera traité comme longueurSource - 3). Si indiceDebut est supérieur à la longueur de la chaîne, slice() renvoie une chaîne vide.
indiceFin
Paramètre optionnel. Un indice base 0 avant lequel terminer l'extraction. Le caractère à cet indice ne sera pas inclus. Si indiceFin est absent, slice() extraira jusqu'à la fin de la chaine de caractères. Si négatif, il sera traité comme (longueurSource + indiceFin) où longueurSource est la longueur de la chaine de caractères (par exemple s'il vaut -3, il sera traité comme longueurSource - 3)

Valeur retournée

Une nouvelle chaîne de caractères contenant la section extraite de la chaîne.

Description

slice() extrait le texte d'une chaine de caractères et retourne une nouvelle chaîne de caractères. Les changements au texte dans une chaine de caractères n'affectent pas l'autre chaîne.

slice() extrait jusqu'à indiceFin, mais sans l'inclure. Par exemple, chn.slice(1, 4) extrait du second caractère jusqu'au quatrième caractère (caractères d'indices 1, 2 et 3).

Par exemple, chn.slice(2, -1) extrait du troisième caractère jusqu'à l'avant-dernier caractère de la chaine de caractères.

Exemples

Utilisation de slice() pour créer une nouvelle chaîne de caractères

L'exemple suivant utilise slice() pour créer une nouvelle chaîne de caractères.

var chn1 = 'Le matin est sur nous.', // la longueur de chn1 est de 22
    chn2 = chn1.slice(1, 8),
    chn3 = chn1.slice(3, -2),
    chn4 = chn1.slice(13),
    chn5 = chn1.slice(30);
console.log(chn2); // SORTIE : e matin
console.log(chn3); // SORTIE : matin est sur nou
console.log(chn4); // SORTIE : sur nous.
console.log(chn5); // SORTIE : ""

Utilisation deslice() avec des indices négatifs

L'exemple suivant utilise slice() avec des indices négatifs.

var chn = 'Le matin est sur nous.';
chn.slice(-3);     // retourne "us."
chn.slice(-3, -1); // retourne "us"
chn.slice(0, -1);  // retourne "Le matin est sur nous"

Spécifications

Spécification Statut Commentaire
ECMAScript 3rd Edition (ECMA-262) Standard Définition initiale. Implémentée dans JavaScript 1.2.
ECMAScript 5.1 (ECMA-262)
La définition de 'String.prototype.slice' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'String.prototype.slice' dans cette spécification.
Standard  
ECMAScript Latest Draft (ECMA-262)
La définition de 'String.prototype.slice' dans cette spécification.
Projet  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung InternetNode.js
Support simpleChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Ouinodejs Support complet Oui

Légende

Support complet  
Support complet

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : SphinxKnight, NemoNobobyPersonne, Goofy, tregagnon
Dernière mise à jour par : SphinxKnight,