String : méthode includes()

Exemple interactif

const sentence = "Le renard brun rapide saute par-dessus le chien paresseux.";

const word = "renard";

console.log(
  `Le mot « ${word} » ${
    sentence.includes(word) ? "est" : "n'est pas"
  } dans la phrase`,
);
// Résultat attendu : "Le mot « renard » est dans la phrase"

Syntaxe

includes(searchString)
includes(searchString, position)

Paramètres

• searchString
  • : Une chaîne de caractères à rechercher dans 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 entraîne la recherche de la chaîne de caractères "undefined", ce qui est rarement souhaité.
• position Facultatif
• : La position dans la chaîne de caractères à partir de laquelle commencer la recherche de searchString. (Par défaut, 0.)

Valeur de retour

true si la chaîne de caractères recherchée est trouvée n'importe où dans la chaîne de caractères donnée, 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 détermine si une chaîne de caractères est contenue dans une autre.

Sensibilité à la case

includes() est sensible à la casse. Par exemple, l'expression suivante nous retourne false  :

"Baleine bleue".includes("baleine"); // retourne false

Vous pouvez contourner cette contrainte en transformant à la fois la chaîne de caractères originale et la chaîne de caractères de recherche en minuscules :

"Baleine bleue".toLowerCase().includes("bleue"); // retourne true

Exemples

Utiliser la méthode includes()

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

console.log(chaine.includes("Être")); // true
console.log(chaine.includes("question")); // true
console.log(chaine.includes("pléonasme")); // false
console.log(chaine.includes("Être", 1)); // false
console.log(chaine.includes("ÊTRE")); // false
console.log(chaine.includes("")); // true

Spécifications

Compatibilité des navigateurs

Voir aussi

• La prothèse d'émulation (polyfill en anglais) de String.prototype.includes dans core-js ^(angl.)
• La prothèse d'émulation (polyfill en anglais) es-shims de String.prototype.includes ^(angl.)
• La méthode Array.prototype.includes()
• La méthode TypedArray.prototype.includes()
• La méthode String.prototype.indexOf()
• La méthode String.prototype.lastIndexOf()
• La méthode String.prototype.startsWith()
• La méthode String.prototype.endsWith()