String.
Vérifie si une chaîne se termine par le texte donné. Renvoie true ou false.
- Renvoie
truesi la chaîne se termine par le texte donné, sinonfalse.- Modifie l’original
- Non
Exemple
#const file = 'avatar.png'
console.log(file.endsWith('.png'))
console.log(file.endsWith('.jpg'))
console.log(file.endsWith('.PNG'))Définition et utilisation
#La méthode endsWith() compare la fin d’une chaîne avec le fragment donné. Elle renvoie true quand le texte se termine exactement comme indiqué, en tenant compte de la casse.
Ses usages typiques sont de vérifier l’extension d’un fichier (.png, .pdf), le domaine d’une adresse e-mail, ou la fin d’un identifiant. La méthode accepte du texte simple, et une expression régulière provoque une erreur TypeError.
Le second argument optionnel, endPosition, fait que la méthode traite la chaîne comme si elle se terminait à cette position. Vous pouvez ainsi vérifier qu’un fragment se termine à un endroit précis du texte.
Syntaxe
#string.endsWith(searchString)
string.endsWith(searchString, endPosition)Paramètres
#searchString
string
Texte par lequel la chaîne doit se terminer.endPosition
number, optionnel
Position traitée comme la fin de la chaîne. Par défautstring.length.
Plus d’exemples
#const files = ['index.html', 'style.css', 'app.js', 'logo.SVG', 'utils.js']
const scripts = files.filter((name) => name.endsWith('.js'))
const images = files.filter((name) => name.toLowerCase().endsWith('.svg'))
console.log(scripts)
console.log(images)const sentence = 'Cours HTML et CSS'
console.log(sentence.endsWith('HTML', 10))
console.log(sentence.endsWith('CSS'))Compatibilité des navigateurs
#Largement disponible
Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.
- Chrome
- Edge
- Firefox
- Safari
Bonnes pratiques
#- Les extensions de fichiers sont parfois écrites en majuscules, comme
.JPG. Convertissez le nom en minuscules avant de le vérifier. - Ne traitez pas l’extension comme une mesure de sécurité. Un fichier nommé
rapport.exe.pngse termine par.png, mais son contenu réel peut être tout autre chose.
Entrées associées
#- String.prototype.startsWith()Vérifie si une chaîne commence par le texte donné. Renvoie true ou false.
- String.prototype.includes()Vérifie si une chaîne contient le fragment de texte donné. Renvoie true ou false et distingue majuscules et minuscules.
- String.prototype.slice()Renvoie un fragment de la chaîne entre un indice de départ et un indice de fin (exclu). Prend en charge les indices négatifs.
- String.prototype.toLowerCase()Renvoie une copie de la chaîne convertie en minuscules. Utile pour les comparaisons et la normalisation des données.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.