HOWTO · JavaScript

JavaScript で変数が文字列かどうかをチェックする

このチュートリアルでは、JavaScript で変数が文字列かどうかを確認する方法を説明します。

このページの内容

typeof value === "string" を使うと、値がプリミティブ文字列かどうかを判定できます。入力検証では通常この方法を選びます。シングルクォート、ダブルクォート、バッククォートはいずれもプリミティブ文字列を作り、引用符の種類によって型は変わりません。

typeof でプリミティブ文字列を判定する

typeof 演算子は、プリミティブ文字列に対して文字列 "string" を返します。その結果を、この値と厳密に比較してください。数値、真偽値、null、オブジェクトでは比較結果は false になります。ローカル変数、関数の引数、ほかのコードから受け取った値に対して使えます。

次の例を実行してください。

このセクションのコードと表示されるラベルや出力は英語のままです。

const primitive = "hello";
const boxed = new String("hello");
const number = 42;

console.log(typeof primitive);
console.log(typeof boxed);
console.log(typeof number === "string");
string
object
false

プリミティブ文字列では "string" が返り、new String("hello") で作成した値では "object" が返ります。42 はプリミティブ文字列との比較に一致しません。値を検証するには typeof value === "string" で比較してください。

Stringオブジェクトを受け入れるか決める

JavaScriptには、ボックス化文字列とも呼ばれるStringオブジェクトもあります。new String("hello") はStringオブジェクトを作りますが、new を付けずに String("hello") と呼ぶとプリミティブ文字列が返ります。通常はプリミティブ文字列を使ってください。ボックス化された値はオブジェクトとして振る舞うため、比較やAPIで予想外の動作をすることがあります。

typeof による判定はプリミティブ文字列を受け入れ、Stringオブジェクトを除外します。typeof new String("hello") は "object" になるためです。これは通常、入力検証に適した動作です。APIが両方の形式を意図的に受け入れる場合は、すべての文字列判定を緩めるのではなく、その要件を個別に決めてください。

value instanceof String は、現在のレルムの String.prototype が値のプロトタイプチェーンに含まれるかを調べます。プリミティブ文字列では false を返します。また、別のブラウザーウィンドウやフレームなど、異なるレルムで作成された本物のStringオブジェクトでも false になることがあります。この判定だけでは、オブジェクトがStringラッパーの内部データを持つことは証明できません。

代替の判定方法とその制限を理解する

Object.prototype.toString.call(value) === "[object String]" は、プリミティブ文字列と通常のStringオブジェクトを判定でき、別レルムのオブジェクトの多くにも対応します。ただし、あらゆる場合に本物の文字列を判定できるわけではありません。オブジェクトは Symbol.toStringTag を使って結果を変更できます。扱う値に照らしてこの制限が許容できる場合に限り、この判定方法を使ってください。

String.prototype.isPrototypeOf(value) は、現在のレルムの String.prototype がオブジェクトのプロトタイプチェーンに含まれるかを調べます。プリミティブではなくオブジェクトが対象で、別レルムに関する制限は instanceof と同様です。この方法も instanceof String も、値が本物のStringラッパーであることや、内部に文字列データを持つことを証明できません。たとえば Object.create(String.prototype) は、どちらのプロトタイプチェーン判定にも合格します。これらの判定方法が答える問いはそれぞれ異なり、互いに置き換えられるものではありません。一般的な型検証には typeof value === "string" を使い、ボックス化オブジェクトを入力として受け入れるかどうかは別途決めてください。

よくある質問

JavaScriptで変数が文字列かどうかを調べるにはどうすればよいですか?

プリミティブ文字列を受け入れるには typeof value === "string" を使います。ほとんどのアプリケーション入力では、これが標準的な方法です。ボックス化された値も受け入れる場合は、その方針を別途明確にしてください。プロトタイプチェーンの判定だけでは、オブジェクトが本物のStringラッパーであることは証明できません。

プリミティブ文字列とStringオブジェクトの違いは何ですか?

プリミティブ文字列は文字列の値です。new String("hello") はその値を包むオブジェクトを作るため、typeof は "object" を返します。APIがStringオブジェクトを特に必要とする場合を除き、プリミティブ文字列を使ってください。

instanceof String はプリミティブ文字列にも使えますか?

いいえ。instanceof は、オブジェクトが現在のレルムの String コンストラクターを継承しているかを調べます。プリミティブ文字列はオブジェクトではありません。

どの判定方法を選べばよいですか?

プリミティブ文字列の検証には typeof を使ってください。同じレルムのStringプロトタイプチェーンを確認する必要がある場合に限り、instanceof String または String.prototype.isPrototypeOf() を使います。どちらも、本物のラッパーであることは証明できません。プリミティブ文字列とボックス化された文字列の両方を認識する必要がある場合は、Symbol.toStringTag によるカスタマイズを考慮したうえで Object.prototype.toString.call() を使ってください。本物の別レルムのラッパーでも、同じレルムを前提とするプロトタイプ判定には合格しないことがあります。