【JavaScript ECMAScript】RegExp::RegExp.prototype.dotAllインスタンスアクセサプロパティの使い方
RegExp.prototype.dotAllインスタンスアクセサプロパティの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
RegExp.prototype.dotAllプロパティは、JavaScriptの正規表現におけるdotAllフラグ(sフラグ)が設定されているかどうかを示す真偽値を保持するプロパティです。このプロパティは、正規表現の動作を制御する重要なフラグの状態を反映します。
通常の正規表現では、ピリオド(.)は改行文字(\n、\rなど)を除くあらゆる単一の文字に一致します。しかし、正規表現にsフラグが適用されている場合、このdotAllモードが有効になり、ピリオド(.)は改行文字を含むすべての文字に一致するようになります。これにより、複数行にわたるテキスト全体を単一の文字列として扱い、パターンマッチングを行うことが可能になります。
RegExp.prototype.dotAllプロパティは、対象の正規表現オブジェクトがsフラグを使用して作成された場合はtrueを返し、sフラグを使用せずに作成された場合はfalseを返します。このプロパティは読み取り専用であり、正規表現オブジェクトが一度作成されるとその値は変更できません。プログラム中で正規表現の動作を確認する際に利用され、特に複数行の文字列処理において、ピリオドが改行を含む全ての文字に一致するのかどうかを動的に判断するのに役立ちます。
公式リファレンス: RegExp.prototype.dotAll
構文(syntax)
1const myRegex = /example/s; 2const hasDotAllFlag = myRegex.dotAll;
引数(parameters)
引数なし
引数はありません
戻り値(return)
boolean
RegExp.prototype.dotAll は、正規表現リテラルに s フラグが付与されているかどうかを示す真偽値(boolean)を返します。s フラグが指定されている場合は true、指定されていない場合は false となります。