Symbol.search

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Die Symbol.search statische Dateneigenschaft repräsentiert das wohlbekannte Symbol Symbol.search. Die String.prototype.search() Methode sucht dieses Symbol im ersten Argument, um die Methode zu finden, die den Index innerhalb eines Strings zurückgibt, der mit dem aktuellen Objekt übereinstimmt.

Für weitere Informationen siehe RegExp.prototype[Symbol.search]() und String.prototype.search().

Probieren Sie es aus

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

Wert

Das wohlbekannte Symbol Symbol.search.

Eigenschaften von `Symbol.search`
Schreibbar	nein
Aufzählbar	nein
Konfigurierbar	nein

Beispiele

Benutzerdefinierte String-Suche

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

console.log("foobar".search(new CaseInsensitiveSearch("BaR"))); // 3

Spezifikationen

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