W3cubDocs

Intl.ListFormat

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⁩.

The Intl.ListFormat object enables language-sensitive list formatting.

Try it

const vehicles = ["Motorcycle", "Bus", "Car"];

const formatter = new Intl.ListFormat("en", {
  style: "long",
  type: "conjunction",
});
console.log(formatter.format(vehicles));
// Expected output: "Motorcycle, Bus, and Car"

const formatter2 = new Intl.ListFormat("de", {
  style: "short",
  type: "disjunction",
});
console.log(formatter2.format(vehicles));
// Expected output: "Motorcycle, Bus oder Car"

const formatter3 = new Intl.ListFormat("en", { style: "narrow", type: "unit" });
console.log(formatter3.format(vehicles));
// Expected output: "Motorcycle Bus Car"

Constructor

Intl.ListFormat(): Creates a new Intl.ListFormat object.

Static methods

Intl.ListFormat.supportedLocalesOf(): Returns an array containing those of the provided locales that are supported without having to fall back to the runtime's default locale.

Instance properties

These properties are defined on Intl.ListFormat.prototype and shared by all Intl.ListFormat instances.

Intl.ListFormat.prototype.constructor: The constructor function that created the instance object. For Intl.ListFormat instances, the initial value is the Intl.ListFormat constructor.
Intl.ListFormat.prototype[Symbol.toStringTag]: The initial value of the [Symbol.toStringTag] property is the string "Intl.ListFormat". This property is used in Object.prototype.toString().

Instance methods

Intl.ListFormat.prototype.format(): Returns a language-specific formatted string representing the elements of the list.
Intl.ListFormat.prototype.formatToParts(): Returns an array of objects representing the different components that can be used to format a list of values in a locale-aware fashion.
Intl.ListFormat.prototype.resolvedOptions(): Returns a new object with properties reflecting the locale and style formatting options computed during the construction of the current Intl.ListFormat object.

Examples

Using format

The following example shows how to create a List formatter using the English language.

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

Using formatToParts

The following example shows how to create a List formatter returning formatted parts

const list = ["Motorcycle", "Bus", "Car"];
console.log(
  new Intl.ListFormat("en-GB", {
    style: "long",
    type: "conjunction",
  }).formatToParts(list),
);

// [ { "type": "element", "value": "Motorcycle" },
//   { "type": "literal", "value": ", " },
//   { "type": "element", "value": "Bus" },
//   { "type": "literal", "value": ", and " },
//   { "type": "element", "value": "Car" } ];

Specifications

Specification
ECMAScript® 2026 Internationalization API Specification> # listformat-objects>

Browser compatibility

	Desktop					Mobile							Server
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS	Bun	Deno	Node.js
`ListFormat`	72	79	78	60	14.1 Only available on macOS Big Sur (11) and above.	72	79	51	14.5	11.0	72	14.5	1.0.3	1.8	13.0.0 12.0.0–13.0.0 Before version 13.0.0, only the locale data for `en-US` is available by default. When other locales are specified, the `ListFormat` instance silently falls back to `en-US`. To make full ICU (locale) data available before version 13, see Node.js documentation on the `--with-intl` option and how to provide the data.
`ListFormat`	72	79	78	60	14.1 Only available on macOS Big Sur (11) and above.	72	79	51	14.5	11.0	72	14.5	1.0.3	1.8	12.0.0 Before version 13.0.0, only the locale data for `en-US` is available by default. See the `ListFormat()` constructor for more details.
`format`	72	79	78	60	14.1 Only available on macOS Big Sur (11) and above.	72	79	51	14.5	11.0	72	14.5	1.0.3	1.8	12.0.0 Before version 13.0.0, only the locale data for `en-US` is available by default. See the `ListFormat()` constructor for more details.
`formatToParts`	72	79	78	60	14.1 Only available on macOS Big Sur (11) and above.	72	79	51	14.5	11.0	72	14.5	1.0.3	1.8	12.0.0 Before version 13.0.0, only the locale data for `en-US` is available by default. See the `ListFormat()` constructor for more details.
`resolvedOptions`	72	79	78	60	14.1 Only available on macOS Big Sur (11) and above.	72	79	51	14.5	11.0	72	14.5	1.0.3	1.8	12.0.0 Before version 13.0.0, only the locale data for `en-US` is available by default. See the `ListFormat()` constructor for more details.
`supportedLocalesOf`	72	79	78	60	14.1 Only available on macOS Big Sur (11) and above.	72	79	51	14.5	11.0	72	14.5	1.0.3	1.8	13.0.0 12.0.0–13.0.0 Before version 13.0.0, only the locale data for `en-US` is available by default. To make full ICU (locale) data available before version 13, see Node.js documentation on the `--with-intl` option and how to provide the data.