CKTIS / JavaScript
String.prototype.includes — rechercher une sous-chaîne
String.prototype.includes vérifie si un texte contient une sous-chaîne donnée et renvoie true ou false. La méthode distingue les majuscules et les minuscules, accepte une position de départ et ne prend pas en charge les expressions régulières ordinaires.
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.includes(searchString)
str.includes(searchString, position)String.prototype.includes recherche une sous-chaîne littérale et renvoie true ou false sans modifier le texte. La méthode distingue les majuscules et les minuscules et compare les unités de code UTF-16 : elle ne normalise pas Unicode et n'applique pas de règles de comparaison propres à une langue.
Le paramètre facultatif position indique l'index de début de correspondance le plus précoce, compté à partir de zéro en unités de code UTF-16. Sa valeur par défaut est 0 ; après conversion en nombre, toute partie fractionnaire est tronquée vers zéro, puis le résultat est limité à l'intervalle allant de 0 à la longueur du texte. Si la méthode atteint l'étape de recherche, elle renvoie true pour un searchString vide, même si la position fournie dépasse la longueur du texte. Toutefois, position est converti avant la recherche : passer un BigInt comme position déclenche une TypeError même si searchString est vide.
Un objet RegExp ordinaire utilisé comme searchString provoque une TypeError ; formellement, le test IsRegExp en décide et tient compte de Symbol.match. Les autres arguments de recherche sont convertis en texte : si l'argument est omis, la recherche porte donc sur "undefined". Appeler la méthode avec null ou undefined comme this provoque une TypeError.
Il s'agit d'une méthode de la bibliothèque standard ECMAScript, et non d'une API Web. La prise en charge dans un navigateur donné doit être vérifiée séparément ; la disponibilité dans Node 24 ne prouve pas la prise en charge par les navigateurs.
Exemples
const text = "JavaScript";
console.log(text.includes("Script"));
console.log(text.includes("script"));
console.log(text.includes("Java", 1));
console.log(text.includes("", 99));
try {
text.includes(/Script/);
} catch (error) {
console.log(error.name);
}Résultat
true false false true TypeError
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.