Intl.ListFormat

Intl.ListFormat()

Creates a new Intl.ListFormat object.

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.

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[@@toStringTag]

The initial value of the @@toStringTag property is the string "Intl.ListFormat". This property is used in Object.prototype.toString().

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.

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

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" } ];

• Intl
• A polyfill of Intl.ListFormat in FormatJS