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 : méthode endsWith()

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

La méthode endsWith() des valeurs String détermine si une chaîne de caractères se termine par les caractères de cette chaîne de caractères, renvoyant true ou false selon le cas.

Exemple interactif

const str1 = "Les chats sont les meilleurs !";

console.log(str1.endsWith("meilleurs !"));
// Résultat attendu : true

console.log(str1.endsWith("meilleurs", 28));
// Résultat attendu : true

const str2 = "Est-ce une question ?";

console.log(str2.endsWith("question"));
// Résultat attendu : false

Syntaxe

js
endsWith(searchString)
endsWith(searchString, endPosition)

Paramètres

searchString

Les caractères à rechercher à la fin de str. Ne peut pas être une expression rationnelle. Toutes les valeurs qui ne sont pas des expressions rationnelles sont converties en chaînes de caractères, donc l'omission de ce paramètre ou le passage de undefined amène endsWith() à rechercher la chaîne de caractères "undefined", ce qui est rarement ce que vous voulez.

endPosition Facultatif

La position de fin à laquelle searchString est censé être trouvé (l'indice du dernier caractère de searchString plus 1). Par défaut, il s'agit de str.length.

Valeur de retour

true si les caractères donnés se trouvent à la fin de la chaîne de caractères, y compris lorsque searchString est une chaîne de caractères vide ; sinon, false.

Exceptions

TypeError

Levée si searchString est une expression rationnelle.

Description

Cette méthode permet de déterminer si une chaîne de caractères se termine ou non par une autre chaîne de caractères. Cette méthode est sensible à la casse.

Exemples

Utiliser la méthode endsWith()

js
const chaine = "Être, ou ne pas être, telle est la question.";

console.log(chaine.endsWith("question.")); // true
console.log(chaine.endsWith("Être")); // false
console.log(chaine.endsWith("pas être", 19)); // true

Spécifications

Spécification
ECMAScript® 2027 Language Specification
# sec-string.prototype.endswith

Compatibilité des navigateurs

Voir aussi