Symbol.replace

Baseline Widely available

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

Symbol.replace は静的データプロパティで、ウェルノウンシンボルである Symbol.replace を表します。String.prototype.replace() および String.prototype.replaceAll() メソッドは第 1 引数で、現在のオブジェクトに一致する部分文字列を置き換えるメソッドを、このシンボルで探します。

詳しくは、RegExp.prototype[Symbol.replace]()String.prototype.replace()String.prototype.replaceAll() を参照してください。

試してみましょう

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"

ウェルノウンシンボル Symbol.replace です。

Symbol.replace のプロパティ属性
書込可能不可
列挙可能不可
設定可能不可

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"

仕様書

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

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
replace

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

関連情報