String.
Vérifie si une chaîne contient le fragment de texte donné. Renvoie true ou false et distingue majuscules et minuscules.
- Renvoie
truesi le fragment apparaît dans la chaîne, sinonfalse.- Modifie l’original
- Non
Exemple
#const description = 'Cours JavaScript pour débutants'
console.log(description.includes('JavaScript'))
console.log(description.includes('javascript'))
console.log(description.includes('Python'))Définition et utilisation
#La méthode includes() répond à une question simple : ce fragment apparaît-il dans le texte ? Elle renvoie true ou false, ce qui la rend parfaite pour des conditions if et pour filtrer des listes.
La comparaison distingue majuscules et minuscules, donc "JavaScript".includes("script") renvoie false. Pour chercher sans tenir compte de la casse, convertissez les deux côtés en minuscules. Le second argument, optionnel, indique l’indice à partir duquel commence la recherche.
La méthode n’accepte que du texte. Lui passer une expression régulière provoque une erreur TypeError, car match() et RegExp.prototype.test() existent pour les motifs. Une chaîne vide "" est considérée comme contenue dans n’importe quel texte.
Syntaxe
#string.includes(searchString)
string.includes(searchString, position)Paramètres
#searchString
string
Fragment recherché. Une expression régulière provoque une erreurTypeError.position
number, optionnel
Indice à partir duquel commence la recherche. Par défaut0.
Plus d’exemples
#const lessons = ['Variables et types', 'Boucles for', 'Fonctions fléchées']
const query = 'BOUCLES'
const found = lessons.filter((lesson) => lesson.toLowerCase().includes(query.toLowerCase()))
console.log(found)const code = 'let a = 1; let b = 2'
console.log(code.includes('let', 1))
console.log(code.includes('let', 12))const comment = 'Super leçon, mais trop peu d’exemples'
const keywords = ['bug', 'exemple', 'confus']
console.log(keywords.some((word) => comment.includes(word)))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
#- Pour vérifier le début ou la fin d’un texte,
startsWith()etendsWith()sont plus lisibles. - Si vous avez besoin de la position du fragment trouvé, et pas seulement d’une réponse oui ou non, utilisez
indexOf().
Entrées associées
#- String.prototype.indexOf()Renvoie l’indice de la première occurrence du texte donné dans une chaîne, ou -1 s’il est absent.
- String.prototype.startsWith()Vérifie si une chaîne commence par le texte donné. Renvoie true ou false.
- String.prototype.endsWith()Vérifie si une chaîne se termine par le texte donné. Renvoie true ou false.
- String.prototype.match()Fait correspondre une chaîne à une expression régulière. Renvoie un tableau avec la correspondance, toutes les correspondances, ou null.
- Array.prototype.includes()Vérifie si un tableau contient la valeur donnée.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.