このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

リテラル文字: a, b

Baseline
広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

リテラル文字は、入力テキスト内で一致するもの自体を示します。

構文

regex
c

引数

c

下記で説明する構文文字以外の単一の文字です。

解説

正規表現では、ほとんどの文字が文字通り現れます。これらは通常、パターンの最も基本的な構成要素です。例えば、HTML タグの削除の例からのパターンです。

js
const pattern = /<.+?>/g;

この例では、.、+、? は構文文字と呼ばれます。これらは正規表現において特別な意味を持っています。パターンの残りの文字(< と >)はリテラル文字です。これらは入力されたテキスト、つまり左と右の山括弧に一致します。

以下は正規表現における構文文字であり、リテラル文字として現れることはありません。

文字クラスの中では、より多くの文字を文字通り記述することができます。詳しい情報は文字クラスのページを参照してください。例えば \. と [.] はどちらもリテラル . に一致します。しかし、v モード文字クラスでは、構文文字として予約されている文字の集合が異なります。下記は、ASCII 文字と、それらを様々なコンテキストでエスケープまたはエスケープせずに記述できるかどうかをまとめた表です。"✅" はその文字自身を表し、"❌" は構文エラーを発生させ、"⚠️" はその文字が有効でも、それ自身以外の意味を持つことを表します。

文字 u または v モードにおける文字クラス外の文字 u モードの文字クラス v モードの文字クラス
エスケープなし エスケープあり エスケープなし エスケープあり エスケープなし エスケープあり
123456789 "'
CEFGHIJKLMN
OPQRTUVXY_
aceghijklmop
quxy
✅❌✅❌✅❌
!#%&,:;<=>@`~ ✅❌✅❌✅✅
] ❌✅❌✅❌✅
()[{} ❌✅✅✅❌✅
*+? ❌✅✅✅✅✅
/ ✅✅✅✅❌✅
0DSWbdfnrstvw ✅⚠️✅⚠️✅⚠️
ABZz ✅⚠️✅❌✅❌
$. ⚠️✅✅✅✅✅
| ⚠️✅✅✅❌✅
- ✅❌✅⚠️✅❌⚠️✅
^ ⚠️✅✅⚠️✅✅⚠️✅
\ ❌⚠️✅❌⚠️✅❌⚠️✅

メモ: v モード文字クラスでエスケープとアンエスケープの両方が可能な文字は、まさに「二重記号」として禁止されている文字です。詳しくはvモード文字クラスを参照してください。

構文文字を文字通りに照合したい場合は、バックスラッシュ (\) でエスケープする必要があります。例えば、パターン中のリテラル文字 * と照合するには、パターンに \* と書く必要があります。構文文字をリテラル文字として使用すると、予期しない結果になるか、構文エラーが発生します。例えば、 /*/ は正規表現として有効ではありません。Unicode 非対応モードでは、]、{、} は文字クラスの終わりや数量詞の区切りとして解釈できない場合、文字通りに現れることがあります。これはウェブ互換性のために非推奨ですので、頼ってはいけません。

正規表現リテラルでは、構文文字ではない一部の文字も、そのままでは使用できません。/ は正規表現リテラルの区切り文字として使用されるため、文字クラスの外ではリテラル文字として記述できません。リテラル / と一致させるには、その位置で \/ とエスケープする必要があります。文字クラス内では、v フラグが設定されている場合を除き、/[/]/ のように / をエスケープせずに記述できます。正規表現リテラルは複数行にまたがれないため、改行文字もリテラル文字として使用できません。代わりに \n のような文字エスケープを使用してください。RegExp() コンストラクターを使用する場合、この区切り文字と改行文字の制限はありません。ただし、文字列リテラルには独自のエスケープ規則があります(例えば、"\\" は単一のバックスラッシュ文字を表すため、new RegExp("\\*") と /\*/ は等価です)。

Unicode 非対応モードでは、パターンは UTF-16 コード単位の並びとして解釈されます。これはサロゲートペアが実際には 2 つのリテラル文字を表していることを意味しています。このため、他の機能と組み合わせると予期しない動作が発生します。

js
/^[😄]$/.test("😄"); // false。このパターンは /^[\ud83d\ude04]$/ と解釈されるため
/^😄+$/.test("😄😄"); // false。このパターンは /^\ud83d\ude04+$/ と解釈されるため

Unicode 対応モードでは、パターンは Unicode コードポイントの並びとして解釈され、サロゲートペアは分割されません。できれば常に u フラグを使用しましょう。

例

リテラル文字の使用

次の例は文字エスケープからコピーしたものです。a と b はパターン内のリテラル文字で、\n は正規表現リテラルでは文字通りに現れないのでエスケープされた文字です。

js
const pattern = /a\nb/;
const string = `a
b`;
console.log(pattern.test(string)); // true

仕様書

仕様書
ECMAScript® 2027 Language Specification
# prod-PatternCharacter

ブラウザーの互換性

関連情報