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

Symbol.search

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨janvier 2020⁩.

Le symbole connu Symbol.search définit la méthode qui renvoie l'indice indiquant la position d'une correspondance trouvée dans une chaîne de caractères grâce à une expression rationnelle. Cette fonction est appelée par la méthode String.prototype.search().

Pour plus d'informations, se référer aux pages sur RegExp.prototype[@@search]() et String.prototype.search().

Exemple interactif

class Search1 {
  constructor(value) {
    this.value = value;
  }
  [Symbol.search](string) {
    return string.indexOf(this.value);
  }
}

console.log("foobar".search(new Search1("bar")));
// Expected output: 3
Attributs de Symbol.search
ÉcrivableNon
ÉnumérableNon
ConfigurableNon

Spécifications

Specification
ECMAScript® 2026 Language Specification
# sec-symbol.search

Compatibilité des navigateurs

Voir aussi