[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/String/includes [Back]  [Original]

String.prototype.includes() - JavaScript | MDN

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

String.prototype.includes()

Baseline Large disponibilit

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 mthode includes() dtermine si une chane de caractres est contenue dans une autre et renvoie true ou false selon le cas de figure.

Dans cet article

Exemple interactif

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"

Syntaxe

js
str.includes(chaneRecherche);
str.includes(chaneRecherche, position);

Paramtres

chaneRecherche

Une chane rechercher dans la chane courante.

position Facultatif

La position dans la chane partir de laquelle commencera la recherche. La valeur par dfaut de position est 0.

Valeur de retour

true si la chane de caractres contient la sous-chane recherche, false sinon.

Description

Cette mthode dtermine si une chane de caractres est contenue dans une autre.

Sensibilit la case

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

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

Exemples

Utiliser includes()

js
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("plonasme")); // false
console.log(str.includes("tre", 1)); // false
console.log(str.includes("TRE")); // false
console.log(str.includes("")); // true

Prothse d'mulation (polyfill)

Cette mthode a t ajoute la spcification ECMAScript 2015 et n'est peut-tre pas encore disponible dans toutes les implmentations JavaScript.

Cependant, vous pouvez facilement polyfill cette mthode pour de vieux navigateurs :

js
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;
  };
}

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-string.prototype.includes

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page