JavaScript Intl.ListFormat() Constructor

Beginner
5 min read
Updated: Nov 2026
3 examples
Constructor

Definition

new Intl.ListFormat(locales, options) builds a formatter that turns an array of strings into one list phrase. English conjunction style becomes "A, B, and C".

Set type to "conjunction" (and), "disjunction" (or), or "unit" (no and/or).

Remember
new Intl.ListFormat(locales, options)
fmt.format(["A", "B", "C"])

type: "conjunction" → and
type: "disjunction" → or
type: "unit" → no and/or

Syntax

Create a ListFormat, then pass an array of strings to format.

JavaScript
const fmt = new Intl.ListFormat("en");
console.log(fmt.format(["A", "B", "C"]));
CallWhat it does
new Intl.ListFormat("en")English list with "and" (conjunction).
fmt.format(["A", "B", "C"])Returns "A, B, and C" in English.
{ type: "disjunction" }Uses "or" instead of "and".
{ type: "unit" }Joins items without and/or, useful for measurements.

A standard JavaScript constructor on the Intl object: create one with new Intl.ListFormat(). No import required. Siblings: Intl.getCanonicalLocales(), Intl.supportedValuesOf(), Intl.Collator(), Intl.DateTimeFormat(), Intl.DisplayNames(), Intl.DurationFormat(), Intl.Locale(), Intl.NumberFormat(), Intl.PluralRules(), Intl.RelativeTimeFormat(), Intl.Segmenter().

Library declarations
JavaScript
// ECMAScript 2018 — Intl.ListFormat
new Intl.ListFormat(locales, options)
fmt.format(list)

// options.type  : "conjunction" | "disjunction" | "unit"
// options.style : "long" | "short" | "narrow"

Parameters

ParameterDescription
localesOptional. Locale string or list, such as "en" or "de".
optionsOptional. Mainly type and style.
listFor format: an iterable of strings.

Return Value

Return ValueDescription
ListFormat objectFrom the constructor.
stringFrom format: the localized list phrase.

JavaScript Examples

Example 1 — Join with "and"

The default English type is conjunction: A, B, and C.

JavaScript
const en = new Intl.ListFormat("en");
const de = new Intl.ListFormat("de");
const items = ["A", "B", "C"];

console.log("en: " + en.format(items));
console.log("de: " + de.format(items));
Try It Yourself

The Try It page first checks that Intl.ListFormat exists, because it may be missing in older browsers. In an older browser it prints a short explanation and the output above. In current browsers it runs the code for real.

How It Works

  1. Default type. Conjunction adds the locale word for "and".
  2. German und. The same array becomes A, B und C.
  3. Array in. Pass any list of strings you already prepared.

Example 2 — Join with "or"

Disjunction style uses "or" for choices.

JavaScript
const fmt = new Intl.ListFormat("en", { type: "disjunction" });

console.log(fmt.format(["A", "B", "C"]));
Try It Yourself

The Try It page first checks that Intl.ListFormat exists, because it may be missing in older browsers. In an older browser it prints a short explanation and the output above. In current browsers it runs the code for real.

How It Works

  1. type disjunction. Tells the formatter to use "or".
  2. Choices. Useful for menus: red, green, or blue.
  3. Same array API. Only the connecting word changes.

Example 3 — Join Measurement Parts

Unit type joins values without and/or, good for lengths and similar pairs.

JavaScript
const fmt = new Intl.ListFormat("en", { type: "unit" });

console.log(fmt.format(["3 ft", "2 in"]));
Try It Yourself

The Try It page first checks that Intl.ListFormat exists, because it may be missing in older browsers. In an older browser it prints a short explanation and the output above. In current browsers it runs the code for real.

How It Works

  1. No and/or. Unit style is for measurement-like sequences.
  2. You supply units. The strings already include ft and in.
  3. Clean join. The formatter only adds the locale list separators.

Browser & Runtime Support

Intl.ListFormat is part of ES2018. Current browsers and Node.js 12+ support it.

✓ ES2018 · Widely supported

Intl.ListFormat

Supported in Chrome 72+, Edge 79+, Firefox 78+, Safari 14.1+, Opera 60+ and Node.js 12+.

ES2018 Standard since
Google Chrome 72+ · Desktop & Mobile
Full support
Microsoft Edge 79+ · Chromium based
Full support
Mozilla Firefox 78+ · Desktop & Mobile
Full support
Apple Safari 14.1+ · macOS & iOS
Full support
Opera 60+ · Chromium based
Full support
Samsung Internet Recent versions · Android
Supported
Android WebView 72+ · Chromium based
Supported
Node.js 12+ · Server runtime
Supported
Deno Supported · JavaScript runtime
Supported
Bun Supported · JavaScript runtime
Supported
Internet Explorer No native support
Not supported
Intl.ListFormat Excellent

Bottom line: Safe in current browsers. Guard with typeof Intl.ListFormat === "function" if you need older Safari or Firefox.

Frequently Asked Questions

It turns an array of strings into one localized list phrase, with the correct separators and and/or word for the locale.
Conjunction uses and (A, B, and C). Disjunction uses or (A, B, or C).
When items are measurement-like parts that should not get and/or, such as 3 ft, 2 in.
No. It only joins the strings you give it. Translate or format each item first.
On older browsers, yes. Check typeof Intl.ListFormat === "function".

Next: Intl.Locale

Learn how to parse a locale tag into language, script and region.

Intl.Locale tutorial →

About the author

Mari Selvan M P
Mari Selvan M P 🔗

Developer, cloud engineer, and technical writer

  • Experience 12 years building web and cloud systems
  • Focus Full Stack Development, AWS, and Developer Education

I write practical tutorials so students and working developers can learn by doing—from databases and APIs to deployment on AWS.

12 people found this page helpful