# Intl.ListFormat

The `Intl.ListFormat` object enables language-sensitive list formatting. It allows you to join arrays of strings with localized separators (like ", ", " and ", " or ").

## 1. Basic Usage

The constructor takes two optional arguments: `locales` and `options`.

```javascript
const vehicles = ['Motorcycle', 'Bus', 'Car'];

const formatter = new Intl.ListFormat('en-US', { style: 'long', type: 'conjunction' });
console.log(formatter.format(vehicles));
// "Motorcycle, Bus, and Car"

const germanFormatter = new Intl.ListFormat('de-DE', { style: 'long', type: 'conjunction' });
console.log(germanFormatter.format(vehicles));
// "Motorcycle, Bus und Car"
```

## 2. Types of Lists

The `type` option controls the logical meaning of the list.

*   `conjunction`: The "and" based list (default).
*   `disjunction`: The "or" based list.
*   `unit`: A list of values (usually with units).

```javascript
const list = ['A', 'B', 'C'];

// Conjunction (AND)
console.log(new Intl.ListFormat('en-US', { type: 'conjunction' }).format(list));
// "A, B, and C"

// Disjunction (OR)
console.log(new Intl.ListFormat('en-US', { type: 'disjunction' }).format(list));
// "A, B, or C"

// Unit
console.log(new Intl.ListFormat('en-US', { type: 'unit' }).format(list));
// "A, B, C"
```

## 3. Styles

The `style` option controls the length of the formatted string.

*   `long`: "A, B, and C" (default)
*   `short`: "A, B, & C"
*   `narrow`: "A, B, C"

## 4. `formatToParts`

Like other Intl objects, `formatToParts` returns an array of objects representing the different components of the formatted string.

```javascript
const formatter = new Intl.ListFormat('en-US', { type: 'conjunction' });
const parts = formatter.formatToParts(['A', 'B']);

console.log(parts);
// [{ type: "element", value: "A" }, { type: "literal", value: " and " }, { type: "element", value: "B" }]
```

[[programming/javascript/vanilla/javascript]]
[[programming/javascript/vanilla/intl-numberformat]]
[[programming/javascript/vanilla/intl-collator]]