La méthode[@@search]() recherche une correspondance entre une expression rationnelle décrite parthis et une chaîne de caractères donnée.

Exemple interactif

class RegExp1 extends RegExp {  constructor(str) {    super(str);    this.pattern = str;  }  [Symbol.search](str) {    return str.indexOf(this.pattern);  }}console.log("table football".search(new RegExp1("foo")));// Expected output: 6

Syntaxe

regexp[Symbol.search](str);

Paramètres

str

Une chaîne de caractères (String) sur laquelle on veut rechercher une correspondance.

Valeur de retour

entier

Si la recherche réussit,[@@search]() renvoie la position de la première correspondance de l'expression rationnelle au sein de la chaîne, sinon elle renvoie-1.

Description

Cette méthode est appelée en interne lors de l'utilisation deString.prototype.search(). Ainsi, les deux exemples qui suivent sont équivalents et le second est la version interne du premier :

"abc".search(/a/);/a/[Symbol.search]("abc");

Cette méthode existe afin de pouvoir adapter le comportement de la recherche pour les sous-classes deRegExp.

Exemples

Appel direct

Cette méthode peut être utilisée commeString.prototype.search(), elle utilise simplement un objetthis différent et un ordre de paramètres différent :

var re = /-/g;var str = "2016-01-02";var résultat = re[Symbol.search](str);console.log(résultat); // 4

Utiliser@@search avec une sous-classe

Les sous-classes deRegExp peuvent surcharger[@@search]() afin de modifier le comportement obtenu :

class MaRegExp extends RegExp {  constructor(str) {    super(str);    this.pattern = str;  }  [Symbol.search](str) {    return str.indexOf(this.pattern);  }}var re = new MaRegExp("a+b");var str = "ab a+b";var résultat = str.search(re); // String.prototype.search appelle re[@@search].console.log(résultat); // 3

Spécifications

Compatibilité des navigateurs

Voir aussi

• String.prototype.search()
• RegExp.prototype[@@match]()
• RegExp.prototype[@@replace]()
• RegExp.prototype[@@split]()
• RegExp.prototype.exec()
• RegExp.prototype.test()