Symbol.replace - JavaScript | MDN

Try it

class Replace1 {
  constructor(value) {
    this.value = value;
  }
  [Symbol.replace](string) {
    return `s/${string}/${this.value}/g`;
  }
}

console.log("foo".replace(new Replace1("bar")));
// Expected output: "s/foo/bar/g"

Value

The well-known symbol Symbol.replace.

Property attributes of Symbol.replace
Writableno
Enumerableno
Configurableno

Examples

Using Symbol.replace

js

class CustomReplacer {
  constructor(value) {
    this.value = value;
  }
  [Symbol.replace](string) {
    return string.replace(this.value, "#!@?");
  }
}

console.log("football".replace(new CustomReplacer("foo"))); // "#!@?tball"

Specifications

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

Browser compatibility

See also

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.