String.prototype.padEnd()

O método padEnd() completa a string atual com uma dada string (repetindo-a, caso necessário) de maneira que a string resultante alcance um comprimento dado. O preenchimento é aplicado a partir do fim (direita) da string atual.

Sintaxe

str.padEnd(targetLength [, padString])

Parâmetros

targetLength
O comprimento da string resultante após a string atual ter sido preenchida. Se o valor é menor do que o próprio comprimento da string atual, a string atual é retornada sem modificações.
padString Optional
A string que deve completar a string atual. Caso o comprimento desta string é 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

Uma String cuja composição vem da string atual, completada por uma string de preenchimento, respeitando o comprimento alvo.

Exemplos

'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 String.prototype.padEnd() caso ela não esteja disponível nativamente.

// https://github.com/uxitten/polyfill/blob/master/string.polyfill.js
// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padEnd
if (!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

Especificação Status Comentário
ECMAScript Latest Draft (ECMA-262)
The definition of 'String.prototype.padEnd' in that specification.		 Rascunho Initial definition in ECMAScript 2017.
ECMAScript 2017 (ECMA-262)
The definition of 'String.prototype.padEnd' in that specification.		 Padrão  

Compatibilidade de browser

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
padEndChrome Full support 57Edge Full support 15Firefox Full support 48IE No support NoOpera Full support 44Safari Full support 10WebView Android Full support 57Chrome Android Full support 57Firefox Android Full support 48Opera Android Full support 43Safari iOS Full support 10Samsung Internet Android Full support 7.0nodejs Full support 8.0.0
Full support 8.0.0
Full support 7.0.0
Disabled
Disabled From version 7.0.0: this feature is behind the --harmony runtime flag.

Legend

Full support  
Full support
No support  
No support
User must explicitly enable this feature.
User must explicitly enable this feature.

Veja também

Tópicos relacionados
  1. Standard built-in objects
  2. String
  3. Propriedades
    1. String.prototype
    2. String.length
  4. Métodos
    1. String.fromCharCode()
    2. String.fromCodePoint()
    3. String.prototype.anchor() [Traduzir]
    4. String.prototype.big() [Traduzir]
    5. String.prototype.blink() [Traduzir]
    6. String.prototype.bold() [Traduzir]
    7. String.prototype.charAt()
    8. String.prototype.charCodeAt()
    9. String.prototype.codePointAt() [Traduzir]
    10. String.prototype.concat()
    11. String.prototype.endsWith()
    12. String.prototype.fixed() [Traduzir]
    13. String.prototype.fontcolor() [Traduzir]
    14. String.prototype.fontsize() [Traduzir]
    15. String.prototype.includes()
    16. String.prototype.indexOf()
    17. String.prototype.italics() [Traduzir]
    18. String.prototype.lastIndexOf()
    19. String.prototype.link() [Traduzir]
    20. String.prototype.localeCompare() [Traduzir]
    21. String.prototype.match()
    22. String.prototype.matchAll() [Traduzir]
    23. String.prototype.normalize()
    24. String.prototype.padEnd()
    25. String.prototype.padStart()
    26. String.prototype.quote() [Traduzir]
    27. String.prototype.repeat()
    28. String.prototype.replace()
    29. String.prototype.search()
    30. String.prototype.slice()
    31. String.prototype.small() [Traduzir]
    32. String.prototype.split()
    33. String.prototype.startsWith()
    34. String.prototype.strike() [Traduzir]
    35. String.prototype.sub()
    36. String.prototype.substr()
    37. String.prototype.substring()
    38. String.prototype.sup() [Traduzir]
    39. String.prototype.toLocaleLowerCase() [Traduzir]
    40. String.prototype.toLocaleUpperCase() [Traduzir]
    41. String.prototype.toLowerCase()
    42. String.prototype.toSource()
    43. String.prototype.toString()
    44. String.prototype.toUpperCase()
    45. String.prototype.trim()
    46. String.prototype.trimEnd() [Traduzir]
    47. String.prototype.trimStart() [Traduzir]
    48. String.prototype.valueOf()
    49. String.prototype[@@iterator]()
    50. String.raw()
  5. Herança:
  6. Function
  7. Propriedades
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.name
    7. Function.prototype
  8. Métodos
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. Propriedades
    1. Object.prototype.__count__
    2. Object.prototype.__noSuchMethod__ [Traduzir]
    3. Object.prototype.__parent__ [Traduzir]
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. Métodos
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__() [Traduzir]
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__() [Traduzir]
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable() [Traduzir]
    8. Object.prototype.toLocaleString() [Traduzir]
    9. Object.prototype.toSource() [Traduzir]
    10. Object.prototype.toString()
    11. Object.prototype.unwatch() [Traduzir]
    12. Object.prototype.valueOf()
    13. Object.prototype.watch() [Traduzir]
    14. Object.setPrototypeOf()