Intl.ListFormat.prototype.format()
The format()
method returns a string with a
language-specific representation of the list.
Syntax
format()
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 |
---|
ECMAScript Internationalization API Specification # sec-Intl.ListFormat.prototype.format |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
format | ChromeFull support72 | EdgeFull support79 | FirefoxFull support78 | Internet ExplorerNo supportNo | OperaFull support60 | SafariFull support14.1 | WebView AndroidFull support72 | Chrome AndroidFull support72 | Firefox for AndroidFull support79 | Opera AndroidFull support51 | Safari on iOSFull support14.5 | Samsung InternetFull support11.0 | DenoFull support1.8 | Node.jsFull support12.0.0 |
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.
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.