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

CKTIS / JavaScript

String.prototype.padEnd — preencher o fim de uma cadeia de caracteres

String.prototype.padEnd preenche o fim de uma cadeia de caracteres até atingir um comprimento-alvo, repetindo uma cadeia fornecida ou usando espaços por predefinição. Não altera a cadeia original nem encurta uma cadeia que já tenha comprimento suficiente.

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

str.padEnd(maxLength[, fillString])

String.prototype.padEnd devolve uma cadeia de caracteres preenchida à direita até ao comprimento maxLength. Este argumento indica o comprimento total pretendido para o resultado, não o número de caracteres a acrescentar. O método não altera a cadeia original. Faz parte do ECMAScript desde a edição de 2017; não é uma API Web. A especificação, por si só, não confirma o suporte num navegador específico.

Se fillString for omitido ou tiver o valor undefined, o preenchimento é feito com um espaço U+0020. Caso contrário, o valor de preenchimento é convertido numa cadeia de caracteres, repetido e, se necessário, truncado no fim. Um fillString vazio não acrescenta nada. Se maxLength não exceder o comprimento da entrada, o método devolve a cadeia sem alterações e sem converter fillString.

A maxLength é aplicada a operação ToLength: a parte fracionária positiva é descartada, enquanto os valores negativos e NaN passam a zero. O comprimento é medido em unidades de código UTF-16, não em caracteres visíveis nem em colunas do ecrã. O truncamento do preenchimento pode separar um par de substitutos; por isso, este método não garante o alinhamento correto de texto Unicode arbitrário.

O exemplo demonstra a repetição e o truncamento do preenchimento, os espaços por predefinição e dois casos sem preenchimento. JSON.stringify torna visíveis os limites da cadeia, permitindo contar os espaços finais.

Exemplos

const label = "ID";
console.log(JSON.stringify(label.padEnd(7, ".-")));
console.log(JSON.stringify(label.padEnd(4)));
console.log(JSON.stringify(label.padEnd(1, "0")));
console.log(JSON.stringify(label.padEnd(7, "")));
console.log(label);

Resultado

"ID.-.-."
"ID  "
"ID"
"ID"
ID

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