Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Intl.ListFormat — formatação de listas segundo as definições regionais

Intl.ListFormat combina elementos de texto de uma lista usando separadores e conjunções adequados às definições regionais. format() devolve texto, enquanto formatToParts() separa os elementos originais do texto de ligação inserido.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

new Intl.ListFormat(locales?, options?).format(list)

Intl.ListFormat é uma API de internacionalização definida pela ECMA-402, não uma API do DOM. Crie um formatador com new Intl.ListFormat(locales, options). O argumento locales indica as definições regionais preferidas; se for omitido, são usadas as definições regionais predefinidas do ambiente.

A opção type aceita "conjunction" (ligação do tipo «e», valor predefinido), "disjunction" (alternativas do tipo «ou») ou "unit" (uma lista de unidades). A opção style aceita "long" (valor predefinido), "short" ou "narrow". O formatador não traduz os elementos nem formata os números ou as unidades propriamente ditos.

format(list) aceita um objeto iterável que contenha apenas cadeias de caracteres; um elemento de outro tipo provoca um TypeError. Uma lista vazia produz "". formatToParts(list) devolve objetos com os campos type e value: "element" identifica um elemento de entrada e "literal" identifica o texto de ligação inserido. Assim, pode realçar os elementos sem analisar a pontuação.

O texto de ligação exato depende dos dados que a implementação usa para as definições regionais; não presuma que é idêntico em todos os ambientes. Verifique se Intl.ListFormat está disponível no ambiente de destino — a sua presença no Node não comprova o suporte nos navegadores. O exemplo verifica a preservação dos elementos e a reconstrução do resultado, não um separador específico.

Exemplos

const formatter = new Intl.ListFormat("en", {
  type: "conjunction",
  style: "long"
});
const items = ["Ada", "Lin", "Sam"];
const parts = formatter.formatToParts(items);
console.log(JSON.stringify(parts.filter(p => p.type === "element").map(p => p.value)));
console.log(parts.map(p => p.value).join("") === formatter.format(items));

Resultado

["Ada","Lin","Sam"]
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes