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.