Web/JavaScript/Reference/Global objects/Intl/ListFormat/format

The format() method returns a string with a language-specific representation of the list.

Syntax

listFormat.format([list]);

Parameters

list

An iterable object, such as an Array

Return value

A language-specific formatted string representing the elements of the list

Description

The format() method returns a string that has been formatted based on parameters provided in the Intl.ListFormat object. The locales and options parameters customize the behavior of format() and let applications specify the language conventions that should be used to format the list.

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

Specifications

Specification
Intl.ListFormatThe definition of 'format()' in that specification.

Browser compatibility

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet	Node.js
format Experimental'	Chrome Full support 72	Edge No support No	Firefox Full support 78	IE No support No	Opera Full support 60	Safari No support No	WebView Android Full support 72	Chrome Android Full support 72	Firefox Android No support No	Opera Android Full support 51	Safari iOS No support No	Samsung Internet Android No support No	nodejs Full support 12.0.0 Notes' Full support 12.0.0 Notes' Notes' Before version 13.0.0, only the locale data for en-US is available by default. See the ListFormat() constructor for more details.

Legend

Full support  

Full support

No support  

No support

Experimental. Expect behavior to change in the future.'

Experimental. Expect behavior to change in the future.

See implementation notes.'

See implementation notes.

See also

• Intl.ListFormat

Intl .ListFormat.prototype .format() by Mozilla Contributors is licensed under CC-BY-SA 2.5.