Construtor Intl.ListFormat()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since abril de 2021.
O construtor Intl.ListFormat() cria objetos
Intl.ListFormat que habilitam a formatação de lista de acordo com o idioma.
Experimente
const vehicles = ["Motorcycle", "Bus", "Car"];
const formatter = new Intl.ListFormat("en", {
style: "long",
type: "conjunction",
});
console.log(formatter.format(vehicles));
// Expected output: "Motorcycle, Bus, and Car"
const formatter2 = new Intl.ListFormat("de", {
style: "short",
type: "disjunction",
});
console.log(formatter2.format(vehicles));
// Expected output: "Motorcycle, Bus oder Car"
const formatter3 = new Intl.ListFormat("en", { style: "narrow", type: "unit" });
console.log(formatter3.format(vehicles));
// Expected output: "Motorcycle Bus Car"
Sintaxe
new Intl.ListFormat();
new Intl.ListFormat(locales);
new Intl.ListFormat(locales, options);
Parâmetros
localesOptional-
Uma string com a tag de idioma BCP 47, ou um array de tais string. Veja de forma geral a interpretação do argumento
locales, na página Intl. optionsOptional-
Um objeto com algumas ou todas as seguintes propriedades:
localeMatcher-
O algoritmo de correspondência de localidade para ser utilizado. Os possíveis valores são "
lookup" e "best fit"; o valor padrão é "best fit". Para mais informações sobre esta opção, veja a página Intl. type-
O formato de saída da mensagem. Os possíveis valores são "
conjunction" que representa listas com "e" (padrão, e.g., "A, B, e C"), ou "disjunction" que representa listas com "ou" (e.g., "A, B, ou C"). "unit" que representa listas com valores de unidade (e.g., "5 libras, 12 onças"). style-
O tamanho da lista formatada. Os possíveis valores são: "
long" (padrão, e.g., "A, B, e C"); "short" (e.g., "A, B, C"), ou "narrow" (e.g., "A B C"). quandostyleé "short" ou "narrow", "unit" é o único valor de tipo permitido.
Exemplos
Utilizando format
O exemplo a seguir mostra como criar um List formatter utilizando o idioma Português.
const list = ["Moto", "Ônibus", "Carro"];
console.log(
new Intl.ListFormat("pt-BR", { style: "long", type: "conjunction" }).format(
list,
),
);
// > Moto, Ônibus e Carro
console.log(
new Intl.ListFormat("pt-BR", { style: "short", type: "disjunction" }).format(
list,
),
);
// > Moto, Ônibus ou Carro
console.log(
new Intl.ListFormat("pt-BR", { style: "narrow", type: "unit" }).format(list),
);
// > Moto Ônibus Carro
Especificações
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification # sec-intl-listformat-constructor |