[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/String/slice [Back]  [Original]

String.prototype.slice() - JavaScript | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

String.prototype.slice()

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 juillet 2015.

La mthode slice() extrait une section d'une chaine de caractres et la retourne comme une nouvelle chaine de caractres. La chane de caractres courante n'est pas modifie.

Dans cet article

Exemple interactif

const str = "The quick brown fox jumps over the lazy dog.";

console.log(str.slice(31));
// Expected output: "the lazy dog."

console.log(str.slice(4, 19));
// Expected output: "quick brown fox"

console.log(str.slice(-4));
// Expected output: "dog."

console.log(str.slice(-9, -5));
// Expected output: "lazy"

Syntaxe

js
chn.slice(indiceDebut[, indiceFin])

Paramtres

indiceDebut

L'indice base 0 auquel commencer l'extraction. Si ngatif, il est trait comme (longueurSource + indiceDebut) o longueurSource est la longueur de la chaine de caractres (par exemple, si indiceDebut est -3, il sera trait comme longueurSource - 3). Si indiceDebut est suprieur la longueur de la chane, slice() renvoie une chane vide.

indiceFin

Paramtre optionnel. Un indice base 0 avant lequel terminer l'extraction. Le caractre cet indice ne sera pas inclus. Si indiceFin est absent, slice() extraira jusqu' la fin de la chaine de caractres. Si ngatif, il sera trait comme (longueurSource + indiceFin) o longueurSource est la longueur de la chaine de caractres (par exemple s'il vaut -3, il sera trait comme longueurSource - 3)

Valeur retourne

Une nouvelle chane de caractres contenant la section extraite de la chane.

Description

slice() extrait le texte d'une chaine de caractres et retourne une nouvelle chane de caractres. Les changements au texte dans une chaine de caractres n'affectent pas l'autre chane.

slice() extrait jusqu' indiceFin, mais sans l'inclure. Par exemple, chn.slice(1, 4) extrait du second caractre jusqu'au quatrime caractre (caractres d'indices 1, 2 et 3).

Par exemple, chn.slice(2, -1) extrait du troisime caractre jusqu' l'avant-dernier caractre de la chaine de caractres.

Exemples

Utilisation de slice() pour crer une nouvelle chane de caractres

L'exemple suivant utilise slice() pour crer une nouvelle chane de caractres.

js
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 de slice() avec des indices ngatifs

L'exemple suivant utilise slice() avec des indices ngatifs.

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

Dans l'exemple qui suit, on commence chercher l'indice de dbut partir de la fin de la chane avec l'argument -11 et on utilise un indice de fin positif avec 16 :

js
console.log(chn.slice(-11, 16)); // "st sur"

On utilise ensuite un indice de dbut positif (la recherche est effectue depuis le dbut de la chane) et un indice de fin ngatif pour parvenir au mme rsultat :

js
console.log(chn.slice(10, -5)); // "st sur"

Enfin, on utilise deux indices ngatifs : la position de dbut et la position de fin sont recherches parti de la fin de la chane :

js
console.log(chn.slice(-11, -5)); // "st sur"

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-string.prototype.slice

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page