Intl.ListFormat

O objeto Intl.ListFormat habilita a formatação de lista de acordo com o idioma.

Experimente

Construtor

Intl.ListFormat(): Criar um novo objeto Intl.ListFormat.

Métodos estáticos

Intl.ListFormat.supportedLocalesOf(): Retorna um array com as localidades fornecidas com suporte sem precisar depender da localidade padrão do tempo de execução.

Métodos de instância

Intl.ListFormat.prototype.format(): Retorna uma string formatada especifica do idioma representando os elementos da lista.
Intl.ListFormat.prototype.formatToParts(): Retorna um array de objetos representando os diferentes componentes que podem ser usados para formatar uma lista de valores com reconhecimento de localidade.

Exemplos

Utilizando format

O exemplo a seguir mostra como criar o 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

Utilizando formatToParts

O exemplo a seguir mostra como criar o List formatter retornando as partes formatadas.

const list = ["Moto", "Ônibus", "Carro"];
console.log(
  new Intl.ListFormat("pt-BR", {
    style: "long",
    type: "conjunction",
  }).formatToParts(list),
);

// [ { "type": "element", "value": "Moto" },
//   { "type": "literal", "value": ", " },
//   { "type": "element", "value": "Ônibus" },
//   { "type": "literal", "value": ", e " },
//   { "type": "element", "value": "Carro" } ];

Especificações

Specification
ECMAScript Internationalization API Specification # listformat-objects

Compatibilidade de browser

BCD tables only load in the browser