HTML: Markup language
CSS: Styling language
JavaScript: Scripting language
Web APIs: Programming interfaces
All web technology
Learn web development
Discover our tools
Get to know MDN better
Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
View in English Always switch to English
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2015.
La méthode includes() détermine si une chaîne de caractères est contenue dans une autre et renvoie true ou false selon le cas de figure.
includes()
true
false
const sentence = "The quick brown fox jumps over the lazy dog."; const word = "fox"; console.log( `The word "${word}" ${ sentence.includes(word) ? "is" : "is not" } in the sentence`, ); // Expected output: "The word "fox" is in the sentence"
str.includes(chaîneRecherchée); str.includes(chaîneRecherchée, position);
chaîneRecherchée
Une chaîne à rechercher dans la chaîne courante.
position
La position dans la chaîne à partir de laquelle commencera la recherche. La valeur par défaut de position est 0.
true si la chaîne de caractères contient la sous-chaîne recherchée, false sinon.
Cette méthode détermine si une chaîne de caractères est contenue dans une autre.
includes() est sensible à la casse. Par exemple, l'expression suivante nous retournera false :
"Baleine bleue".includes("baleine"); // false
const str = "Être ou ne pas être, telle est la question."; console.log(str.includes("Être")); // true console.log(str.includes("question")); // true console.log(str.includes("pléonasme")); // false console.log(str.includes("Être", 1)); // false console.log(str.includes("ÊTRE")); // false console.log(str.includes("")); // true
Cette méthode a été ajoutée à la spécification ECMAScript 2015 et n'est peut-être pas encore disponible dans toutes les implémentations JavaScript.
Cependant, vous pouvez facilement polyfill cette méthode pour de vieux navigateurs :
if (!String.prototype.includes) { String.prototype.includes = function (search, start) { "use strict"; if (search instanceof RegExp) { throw TypeError("first argument must not be a RegExp"); } if (start === undefined) { start = 0; } return this.indexOf(search, start) !== -1; }; }
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.
Array.prototype.includes()
TypedArray.prototype.includes()
String.prototype.indexOf()
String.prototype.lastIndexOf()
String.prototype.startsWith()
String.prototype.endsWith()