Intl.Locale.prototype.caseFirst

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

Intl.Locale.prototype.caseFirst プロパティは、ロケールの照合規則に大文字小文字を考慮するかどうかを返すアクセサープロパティです。

解説

ロケールの照合規則は、そのロケールでの文字列の並び順を決定するために用いられます。ロケールによっては、照合処理で文字の大文字小文字を使用する場合があります。この追加ルールは、 LocalecaseFirst プロパティで表現することができます。

caseFirst プロパティには下記の表にある通り、 3 種類の値を指定することができます。

caseFirst の値

説明
upper 大文字が小文字よりも前に並べられます。
lower 小文字が大文字よりも前に並べられます。
false 大文字と小文字で特別な並べ替えはしません。

ロケール文字列による caseFirst 値の設定

Unicode ロケール文字列仕様書では、 caseFirst が表す値は kf キーに対応します。 kf はロケール文字列の「拡張子サブタグ」として扱われます。これらのサブタグは、ロケールに関するデータを追加するもので、 -u 拡張を使用してロケール識別子に追加されます。つまり、 caseFirst の値は、 Locale コンストラクターに渡される初期のロケール識別子文字列に追加することができます。 caseFirst の値を追加するには、まず文字列に -u 拡張キーを追加します。次に、照合順序の型を追加することを示すために -kf 拡張キーを追加します。最後に、 caseFirst の値を文字列に追加します。

js
let locale = new Intl.Locale("fr-Latn-FR-u-kf-upper");
console.log(locale.caseFirst); // "upper" と表示

構成オブジェクト引数による caseFirst の値の設定

Intl.Locale コンストラクターには、オプションで構成オブジェクトの引数があり、拡張の種類を渡すために使用することができます。構成オブジェクトの caseFirst プロパティを望みの caseFirst の値に設定し、コンストラクターに渡します。

js
let locale = new Intl.Locale("en-Latn-US", { caseFirst: "lower" });
console.log(locale.caseFirst); // "lower" と表示

仕様書

Specification
ECMAScript® 2025 Internationalization API Specification
# sec-Intl.Locale.prototype.caseFirst

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
caseFirst

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

関連情報