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

【JavaScript ECMAScript】RangeError: form must be one of 'NFC', 'NFD', 'NFKC', or 'NFKD'エラーの使い方

RangeError: form must be one of 'NFC', 'NFD', 'NFKC', or 'NFKD'エラーの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

RangeError: form must be one of 'NFC', 'NFD', 'NFKC', or 'NFKD'定数は、JavaScriptにおいて文字列の正規化を行うString.prototype.normalize()メソッドのform引数に、無効な値が指定された際に発生するエラーメッセージを表す定数です。このエラーは、指定された値が有効な範囲外である場合にスローされるRangeErrorの一種として分類されます。

String.prototype.normalize()メソッドは、例えば全角カナと半角カナ、またはアクセント記号付きの文字など、見た目は同じでも内部的な表現形式が異なる文字を、統一された標準形式に変換(正規化)するために使用されます。この正規化処理は、国際化対応や異なるシステム間でのデータ連携において、文字列の厳密な比較や整合性を保つ上で非常に重要です。

このメソッドを使う際、form引数にはどの正規化形式を適用するかを指定する必要があります。JavaScriptの標準では、以下のいずれかの文字列のみが有効な値として許可されています。

  • 'NFC': 標準的な合成済み文字の正規化形式です。
  • 'NFD': 分解された文字の正規化形式です。
  • 'NFKC': 互換性のある分解と合成済み文字の正規化形式です。
  • 'NFKD': 互換性のある分解と分解された文字の正規化形式です。

これらの有効な文字列以外の値がform引数に渡されると、プログラムはこのRangeErrorを発生させ、実行を停止します。システムエンジニアを目指す初心者の方は、String.prototype.normalize()を使用する際には、必ずform引数に上記4つのいずれかの文字列を正確に指定するようにしてください。そうすることで、文字列の正規化処理が正しく行われ、安定したプログラム動作が期待できます。

構文(syntax)

1"hello".normalize("invalid_form_type");

引数(parameters)

引数なし

引数はありません

戻り値(return)

戻り値なし

戻り値はありません

関連コンテンツ

関連プログラミング言語