Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Node.js24.x】RegExp::leftContextプロパティの使い方

leftContextプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

leftContextプロパティは、正規表現による文字列検索が成功した場合に、マッチした文字列の直前までの部分文字列を保持するプロパティです。このプロパティはRegExpオブジェクトの静的プロパティであり、最後に成功した正規表現のマッチング結果に影響を受けます。具体的には、正規表現が対象文字列内で合致する箇所を見つけた際、その合致部分より左側にあるすべての文字列がこのプロパティに格納されます。

例えば、「hello world」という文字列に対して「world」という正規表現で検索を行い、マッチングが成功した場合、leftContextプロパティには「hello 」(スペースを含む)という文字列が保持されます。

ただし、このleftContextプロパティはJavaScriptの古い仕様の一部であり、現在では非推奨とされています。そのため、新しいコードで利用することは推奨されません。将来的な互換性やコードの可読性を考慮すると、String.prototype.match()メソッドやRegExp.prototype.exec()メソッドの戻り値を利用して、マッチした部分のインデックスや長さを基にご自身で部分文字列を抽出する方法がより現代的で推奨されるアプローチです。この方法は、予期せぬ挙動を防ぎ、より堅牢なコードを記述することにつながります。

構文(syntax)

1const text = "Hello world! This is a test.";
2const regex = /world/;
3regex.exec(text);
4console.log(RegExp.leftContext);

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

RegExp.prototype.leftContext プロパティは、直前の正規表現マッチング操作において、マッチした部分文字列の左側にあった文字列を返します。

関連コンテンツ

関連プログラミング言語