Intl.ListFormat.prototype.format()

Baseline Widely available

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

format() メソッドは、リストの言語固有の表現を文字列で返します。

試してみましょう

構文

js
format();
format(list);

引数

list

Array などの反復可能オブジェクトです。

返値

リストのすべての要素を表現する、言語に依存した文字列表現です。

解説

format() メソッドは、 Intl.ListFormat オブジェクトで提供された引数に基づいて書式化された文字列を返します。 locales と options 引数で format() の動作をカスタマイズし、アプリケーションがリストを書式化する言語の慣習を指定することができます。

例

format の使用

以下の例では、英語を使用したリストのフォーマッターの作り方を紹介します。

js
const list = ["Motorcycle", "Bus", "Car"];

console.log(
  new Intl.ListFormat("en-GB", { style: "long", type: "conjunction" }).format(
    list,
  ),
);
// > Motorcycle, Bus and Car

console.log(
  new Intl.ListFormat("en-GB", { style: "short", type: "disjunction" }).format(
    list,
  ),
);
// > Motorcycle, Bus or Car

console.log(
  new Intl.ListFormat("en-GB", { style: "narrow", type: "unit" }).format(list),
);
// > Motorcycle Bus Car

仕様書

Specification
ECMAScript Internationalization API Specification
# sec-Intl.ListFormat.prototype.format

ブラウザーの互換性

BCD tables only load in the browser

関連情報