String.prototype.normalize()

概要

引数で与えられた文字列(その値が文字列でない場合、最初の文字列に変換されます)のFormの形式で正規化したUnicode文字列を返します。

構文

str.normalize([form])

引数

form

Formの形式で正規化したUnicode文字列を示す"NFC"、"NFD"、"NFKC"、"NFKD"のうちの一つ。省略されたり、undefinedなら、"NFC"が使用されます。

• NFC — Normalization Form Canonical Composition.
• NFD — Normalization Form Canonical Decomposition.
• NFKC — Normalization Form Compatibility Composition.
• NFKD — Normalization Form Compatibility Decomposition.

スロー

RangeError

formが上記で指定した値の一つでない場合、RangeErrorがスローされます。

説明

normalize() メソッドは文字列の指定したForm形式で正規化したUnicode文字列を返します。文字列自体の値には影響を与えません。

例

例: normalize()を使う

// Initial string

// U+1E9B: LATIN SMALL LETTER LONG S WITH DOT ABOVE
// U+0323: COMBINING DOT BELOW
var str = '\u1E9B\u0323';


// Canonically-composed form (NFC)

// U+1E9B: LATIN SMALL LETTER LONG S WITH DOT ABOVE
// U+0323: COMBINING DOT BELOW
str.normalize('NFC'); // '\u1E9B\u0323'
str.normalize();      // same as above


// Canonically-decomposed form (NFD)

// U+017F: LATIN SMALL LETTER LONG S
// U+0323: COMBINING DOT BELOW
// U+0307: COMBINING DOT ABOVE
str.normalize('NFD'); // '\u017F\u0323\u0307'


// Compatibly-composed (NFKC)

// U+1E69: LATIN SMALL LETTER S WITH DOT BELOW AND DOT ABOVE
str.normalize('NFKC'); // '\u1E69'


// Compatibly-decomposed (NFKD)

// U+0073: LATIN SMALL LETTER S
// U+0323: COMBINING DOT BELOW
// U+0307: COMBINING DOT ABOVE
str.normalize('NFKD'); // '\u0073\u0323\u0307'

仕様

ブラウザ実装状況

関連情報

• Unicode Standard Annex #15, Unicode Normalization Forms
• Unicode equivalence