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
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 deundefinedamèneendsWith()à rechercher la chaîne de caractères"undefined", ce qui est rarement ce que vous voulez. endPositionFacultatif-
La position de fin à laquelle
searchStringest censé être trouvé (l'indice du dernier caractère desearchStringplus 1). Par défaut, il s'agit destr.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
searchStringest 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()
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
- La prothèse d'émulation (polyfill en anglais) de
String.prototype.endsWithdanscore-js(angl.) - La prothèse d'émulation (polyfill en anglais) es-shims de
String.prototype.endsWith(angl.) - La méthode
String.prototype.startsWith() - La méthode
String.prototype.includes() - La méthode
String.prototype.indexOf() - La méthode
String.prototype.lastIndexOf()