【JSリファレンス】Symbol.replace

更新日:2024/06/14

Symbol.replaceは、Symbolコンストラクターのプロパティです。

既知シンボル(well-known symbol) @@replace の実体を返します。
オブジェクトのプロパティ名として既知シンボルを使用すると、そのプロパティが一部の組み込みメソッドまたは演算子から参照されます。

[Symbol.replace]プロパティは、String.prototype.replace()によって呼び出されます。

プロパティの値として次の関数が想定されます。


文字列および置換文字列を受け取り、何らかの値を返す関数

String.prototype.replace()は文字列から特定の文字列を検索して任意の文字列に置き換えた結果を返すメソッドです。
そのため、独自に作成したオブジェクトの[Symbol.replace]()メソッドも同様の結果を返すことが期待されます。
(ただし検索値が与えられないため、検索する値はメソッド側で判断する必要があります。)

実際には[Symbol.replace]()メソッドは、任意の値を返すことができます。
String.prototype.replace()は戻り値のチェックを行いません。

 

■使用例

const obj = {
    [Symbol.replace]: function(text,replaceValue) {
        return text + "|" + replaceValue;
    }
};

console.log( "abc".replace(obj,"def") ); // abc|def
関連ページ
RegExp.prototype[@@replace]()

更新日:2024/06/14

書いた人(管理人):けーちゃん

スポンサーリンク

記事の内容について

null

こんにちはけーちゃんです。
説明するのって難しいですね。

「なんか言ってることおかしくない?」
たぶん、こんなご意見あると思います。

裏付けを取りながら記事を作成していますが、僕の勘違いだったり、そもそも情報源の内容が間違えていたりで、正確でないことが多いと思います。
そんなときは、ご意見もらえたら嬉しいです。

掲載コードについては事前に動作確認をしていますが、貼り付け後に体裁を整えるなどをした結果動作しないものになっていることがあります。
生暖かい視線でスルーするか、ご指摘ください。

ご意見、ご指摘はこちら。
https://jsref.affi-sapo-sv.com/info.php

 

このサイトは、リンクフリーです。大歓迎です。