HOWTO · JavaScript

JavaScript で文字列を比較する

JavaScript では、2つの文字列を `localeCompare()` メソッドで比較できます。戻り値は、基準の文字列が相手より照合順序で前なら負の数、同等なら 0、後なら正の数です。戻り値の数値そのものではなく、符号で判定してください。

このページの内容

JavaScriptで文字列を並べる方法には、主に2つあります。localeCompare() は照合規則を適用し、関係演算子は文字列をUTF-16コード単位で比較します。必要な順序に応じて選びましょう。言語に応じた名前やラベルには通常、照合が適しています。コード単位で比較する必要がある場合は < または > を使います。

localeCompare() で文字列を比較する

基準となる文字列に localeCompare() を呼び出し、比較する文字列を引数に渡します。選択した照合順序で基準の文字列が相手より前なら負の数、照合上同等なら0、後なら正の数が返ります。数値の大きさは実装によって異なるため、-1 や 1 そのものを期待せず、符号で判定してください。

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

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

const pairs = [
  ['apple', 'banana'],
  ['pear', 'pear'],
  ['plum', 'grape'],
];

for (const [reference, other] of pairs) {
  const result = reference.localeCompare(other);
  const order = result < 0 ? 'before' : result > 0 ? 'after' : 'equivalent';
  console.log(`${reference}: ${order} ${other}`);
}

ここでは、ドットの前にある reference が基準の文字列で、other が引数です。戻り値は2つの文字列の照合順序上の相対的な位置を示し、文字列間の距離を表すものではありません。照合順序はロケールの規則に依存するため、句読点、文字の異形、言語固有の並び順は、コード単位による比較とは異なる場合があります。

関係演算子で文字列を比較する

< と > 演算子は、UTF-16コード単位に基づいて2つの文字列を辞書順に比較します。言語ごとの照合規則は適用されません。たとえば、大文字と小文字はこの順序で異なる位置になることがあり、アクセント付き文字も言語固有の異形としてではなく、それぞれのコード単位に従って並びます。ロジック上コード単位による順序が必要な場合に使い、一般的なアルファベット順として扱わないでください。

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

const first = 'apple';
const second = 'banana';

console.log(first < second);
console.log(first === second);
console.log(first > second);

2つの文字列が同じコード単位の並びかどうかを調べるには === を使います。相対的な順序が必要なら < または > を使います。これらの演算子は単純な順序判定を簡潔に書けますが、大文字やアクセントの区別を調整するようなロケール対応オプションはありません。

localeCompare() で文字列を並べ替える

JavaScriptの Array.prototype.sort() には比較コールバックを渡せます。a.localeCompare(b) の結果を返すと、照合規則に従って各ペアをどの順序にするかを sort() に伝えられます。戻り値が必ず -1、0、1 のいずれかだと仮定した比較関数を書く必要はありません。

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

const names = ['Zoe', 'Åke', 'Ana'];
names.sort((a, b) => a.localeCompare(b));
console.log(names.join(', '));

出力例:

Åke, Ana, Zoe

正確な順序は、実行環境の既定ロケールや照合データによって変わることがあります。ユーザーや環境が異なっても同じ順序にする必要がある場合は、a.localeCompare(b, 'en') のようにロケールを明示し、製品の要件に合うオプションを選びます。ソートは配列をその場で変更するため、元の順序を保つ必要がある場合は先にコピーしてください。

大文字とアクセントの区別に関するオプションを選ぶ

localeCompare() の省略可能な第3引数には、オプションオブジェクトを指定できます。sensitivity 設定で、どの違いを区別するかを制御します。base は大文字小文字やアクセントだけが異なる文字列を照合上同等として扱います。accent はアクセントを区別し、大文字小文字は区別しません。case は大文字小文字を区別し、アクセントは区別しません。variant は両方を区別します。具体的な順序は、引き続き選択したロケールに従います。

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

const accented = 'café';
const plain = 'cafe';
const result = accented.localeCompare(plain, 'en', { sensitivity: 'base' });
console.log(result === 0);

大文字小文字やアクセントの違いを並べ替えに反映させたくない検索や一覧には base を選びます。読者やデータにとって区別が重要な場合は、より区別の強い設定を使います。大文字小文字を区別しないソートでは、コールバックに同じ感度オプションを渡します。たとえば items.sort((a, b) => a.localeCompare(b, 'en', { sensitivity: 'base' })) のように指定します。このオプションは照合の動作を変えますが、元の文字列を書き換えたり正規化したりはしません。

まとめると、言語に応じた並べ替えには localeCompare() を使い、インターフェースで必要な区別に合わせてオプションを選びます。定義された特定のUTF-16順序が必要なら関係演算子を使い、文字列が完全に一致するかを調べるには厳密等価演算子を使います。localeCompare() の戻り値が常に特定の数値になると期待したり、関係演算子による順序をユーザーの言語規則の代わりにしたりしないでください。