Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

String.prototype.endsWith — vérifier la fin d’une chaîne

String.prototype.endsWith vérifie si une chaîne se termine par le texte indiqué et renvoie true ou false. La méthode distingue les majuscules des minuscules, ne modifie pas la chaîne et permet de définir une limite de fin antérieure pour la vérification.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

str.endsWith(searchString[, endPosition])

String.prototype.endsWith compare searchString à la fin d’une chaîne et renvoie true ou false sans modifier la chaîne d’origine. La comparaison distingue les majuscules des minuscules et s’effectue sur des unités de code UTF-16, sans normalisation Unicode. Il s’agit d’une méthode de la bibliothèque standard ECMAScript, et non d’une API de navigateur.

Le paramètre facultatif endPosition définit une limite de fin exclusive : la méthode vérifie la fin du préfixe qui s’arrête à cette limite, et non une sous-chaîne qui commence à cet endroit. Si cet argument est omis ou vaut undefined, la longueur complète est utilisée. Après conversion en entier, la valeur est limitée à l’intervalle allant de 0 à la longueur de la chaîne ; les valeurs négatives ne comptent pas à rebours depuis la fin. Les positions sont mesurées en unités de code UTF-16.

Lorsque searchString est vide, la méthode renvoie true, même à la limite 0, à condition que la conversion de endPosition, si elle est nécessaire, réussisse. Cette conversion précède la comparaison : passer 0n comme valeur de endPosition provoque une TypeError même si searchString est vide. L’argument searchString est converti en chaîne : s’il est omis, le texte "undefined" est donc utilisé. Un argument reconnu comme expression régulière provoque une TypeError. Appeler la méthode avec null ou undefined comme valeur de this provoque également une TypeError.

Dans l’exemple, la limite 10 se trouve juste après report.txt. La vérification de .txt renvoie donc true, même si la chaîne entière se termine par .bak. La vérification de .BAK renvoie false, car la casse est différente.

Exemples

const filename = "report.txt.bak";
console.log(filename.endsWith(".bak"));
console.log(filename.endsWith(".txt", 10));
console.log(filename.endsWith(".BAK"));
console.log(filename.endsWith("", 0));

Résultat

true
true
false
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources