Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
String.prototype.padEnd()
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 2017.
O métodopadEnd() preenche a string original com um determinado caractere, ou conjunto de caraceres, (repetidamente, se necessário) para que a string resultante alcance um determinado comprimento. O preenchimento é aplicado a partir do final (direita) da string original. A string original não é modificada.
Experimente
const str1 = "Breaded Mushrooms";console.log(str1.padEnd(25, "."));// Expected output: "Breaded Mushrooms........"const str2 = "200";console.log(str2.padEnd(5));// Expected output: "200 "Sintaxe
str.padEnd(targetLength [, padString])
Parâmetros
targetLengthO comprimento da string resultante após a string original ter sido preenchida. Se o valor for menor do que o próprio comprimento da string original, a string original é retornada sem modificações.
padStringOpcional. O caractere (ou caracteres) que deve completar a string atual. Caso o comprimento desta string seja muito longo, estando acima do comprimento alvo, ela será truncada e sua parte esquerda restante é aplicada. O valor padrão para esse parâmetro é " " (
U+0020).
Valor retornado
UmaString cuja composição vem da string original, completada por um ou mais caracteres de preenchimento, respeitando o comprimento alvo.
Exemplos
Usando padEnd
"abc".padEnd(10); // "abc ""abc".padEnd(10, "foo"); // "abcfoofoof""abc".padEnd(6, "123456"); // "abc123""abc".padEnd(1); // "abc"Polyfill
Rodando o seguinte código antes de qualquer código irá criar o métodoString.prototype.padEnd() caso ele não esteja disponível nativamente:
// https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/String/padEndif (!String.prototype.padEnd) { String.prototype.padEnd = function padEnd(targetLength, padString) { targetLength = targetLength >> 0; //floor if number or convert non-number to 0; padString = String(typeof padString !== "undefined" ? padString : " "); if (this.length > targetLength) { return String(this); } else { targetLength = targetLength - this.length; if (targetLength > padString.length) { padString += padString.repeat(targetLength / padString.length); //append to original to ensure we are longer than needed } return String(this) + padString.slice(0, targetLength); } };}Especificações
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.padend |