The format()
method returns a string with a language-specific representation of the list.
Intl.ListFormat.prototype.format()
Try it
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
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | Deno | Node.js | |
format |
72
|
79
|
78
|
No
|
60
|
14.1
Only available on macOS Big Sur (11) and above.
|
72
|
72
|
79
|
51
|
14.5
|
11.0
|
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.
|
See also
© 2005–2022 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/ListFormat/format