【Node.js24.x】Symbol::split定数の使い方

split定数は、文字列を分割するString.prototype.split()メソッドの動作をカスタマイズするために使われる、特別な意味を持つシンボルを表す定数です。

JavaScriptには、オブジェクトのプロパティキーとして利用されるユニークな値である「シンボル」という種類があります。その中でもSymbol.splitは、特定の組み込み操作の振る舞いを定義するためにあらかじめ用意された「Well-known Symbol」と呼ばれる特別なシンボルの一つです。

通常、String.prototype.split()メソッドは、引数として渡された文字列や正規表現を区切り文字として使用し、元の文字列を分割して配列を返します。しかし、もしこのSymbol.split定数をプロパティとして定義したオブジェクトをString.prototype.split()メソッドの引数に渡した場合、String.prototype.split()はそのオブジェクトが持つSymbol.splitという名前のメソッドを呼び出します。

これにより、開発者は標準の文字列や正規表現による分割だけでなく、独自のロジックを持つオブジェクトを作成し、それをString.prototype.split()に渡すことで、文字列の分割方法を柔軟に制御できるようになります。この定数は、文字列分割の振る舞いを拡張し、より複雑なカスタム分割処理を可能にするための重要な仕組みとして機能します。

Copy
1const myCustomSplitter = {
2  [Symbol.split](string, limit) {
3    return string.split(' ');
4  }
5};

引数なし

引数はありません

symbol

Symbol.split は、文字列の split() メソッドの動作をカスタマイズするために使用される組み込みシンボルです。このシンボルは、文字列の split() メソッドが呼び出された際に、その区切り文字として使用されることが期待される特別な値です。