Tradução em progresso.
O método padStart()preenche a string alvo com outra string (múltiplas vezes, se necessário) até que a string resultante alcance o comprimento estipulado. O preenchimento é aplicado a partir do início (esquerda) da string alvo.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Sintaxe
str.padStart(targetLength [, padString])
Parâmetros
targetLength- O comprimento da string resultante uma vez que a string alvo tenha sido preenchida. Caso seu valor seja menor do que o comprimento da string alvo, é retornado a própria string alvo, sem alterações.
padStringOptional- A string que deve preencher a string alvo. Caso o comprimento dessa essa string de preenchimento seja superior ao
targetLength, ela será truncada a partir da direita. O valor padrão é" "(U+0020 'SPACE').
Valor de retorno
Uma String de comprimento específico com uma string de preenchimento aplicada a partir do seu início.
Exemplos
'abc'.padStart(10); // " abc" 'abc'.padStart(10, "foo"); // "foofoofabc" 'abc'.padStart(6,"123465"); // "123abc" 'abc'.padStart(8, "0"); // "00000abc" 'abc'.padStart(1); // "abc"
Polyfill
Ao executar o seguinte código antes de qualquer outro código é criado String.prototype.padStart(), em casos onde ele não está 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/padStart
if (!String.prototype.padStart) {
String.prototype.padStart = function padStart(targetLength, padString) {
targetLength = targetLength >> 0; //truncate 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 padString.slice(0, targetLength) + String(this);
}
};
}
Especificações
| Especificação | Status | Comentário |
|---|---|---|
| ECMAScript Latest Draft (ECMA-262) The definition of 'String.prototype.padStart' in that specification. |
Rascunho | Initial definition in ECMAScript 2017. |
| ECMAScript 2017 (ECMA-262) The definition of 'String.prototype.padStart' in that specification. |
Padrão |
Compatibilidade de Navegador
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Desktop | Mobile | Server | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Basic support | Chrome Full support 57 | Edge Full support 15 | Firefox Full support 48 | IE No support No | Opera Full support 44 | Safari Full support 10 | WebView Android Full support 57 | Chrome Android Full support 57 | Edge Mobile Full support Yes | Firefox Android Full support 48 | Opera Android Full support 44 | Safari iOS Full support 10 | Samsung Internet Android Full support 7.0 | nodejs
Full support
8.0.0
|
Legend
- Full support
- Full support
- No support
- No support
- User must explicitly enable this feature.
- User must explicitly enable this feature.