Méthode substr() de chaîne JavaScript

Définition et utilisation

substr() La méthode extrait une partie de la chaîne.

substr() La méthode commence à partir de la position spécifiée et retourne un nombre spécifié de caractères.

substr() La méthode ne change pas la chaîne originale.

Pour extraire des caractères à partir de la fin de la chaîne, utilisez une position de départ négative.

Astuce :substr() Méthode spécifiant la position de départ et la longueur de la sous-chaîne, c'est substring() Méthode et slice() Méthode utile en remplacement d'une autre, les deux dernières spécifiant la position du caractère de départ.

Voir également :

Méthode split()

Méthode slice()

Méthode substring()

Exemple

Exemple 1

Extraire une sous-chaîne à partir du texte :

let text = "Hello world!";
let result = text.substr(1, 4);"

Essayez-le vous-même

Exemple 2

À partir de la position 2 :

let result = text.substr(2);

Essayez-le vous-même

Exemple 3

Ne extraire que le premier :

let result = text.substr(0, 1);

Essayez-le vous-même

Exemple 4

Ne extraire que le dernier :

let result = text.substr(text.length-1, 1);

Essayez-le vous-même

Exemple 5

Extraire les six derniers :

let result = text.substr(-5, 5);

Essayez-le vous-même

Syntaxe

string.substr(start, length)

Paramètres

Paramètres Description
start

Obligatoire. Position de départ.

Le premier caractère est à l'index 0.

Si start supérieur à la longueur, substr() retourne "".

Si start Si négatif, substr() commence à compter à partir de la fin de la chaîne.

length

Optionnel. Nombre de caractères à extraire.

Si omis, le reste de la chaîne est extrait.

Valeur de retour

Type Description
Chaîne

Chaîne contenant la partie extraite.

Si la longueur est 0 ou négative, une chaîne vide est retournée.

Support du navigateur

substr() est une caractéristique de ECMAScript1 (ES1).

Tous les navigateurs supportent complètement ES1 (JavaScript 1997) :

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
support support support support support support

pages associées

Chaîne JavaScript

Méthodes de chaîne JavaScript

Recherche de chaîne JavaScript