Start · Sprachen · JavaScript · Referenz · String.prototype.padStart()

String.prototype.padStart()

Methode

Die Methode <code>padStart()</code> füllt einen String am Anfang mit einem angegebenen String auf, bis eine bestimmte Ziellänge erreicht ist.

Kategorie: method-property

Signatur

padStart(targetLength) / padStart(targetLength, padString)

Beschreibung

Die Methode padStart() von String-Werten füllt diesen String mit einem angegebenen String auf (wiederholt und/oder abgeschnitten, falls nötig), sodass der resultierende String eine bestimmte Länge hat. Die Auffüllung wird am Anfang dieses Strings vorgenommen.

Parameter

Name Typ Default Beschreibung
$targetLength Pflicht number Die Länge des resultierenden Strings, nachdem der aktuelle str aufgefüllt wurde. Ist der Wert kleiner oder gleich str.length, wird str unverändert zurückgegeben.
$padString string " " (U+0020) Der String, mit dem der aktuelle str aufgefüllt werden soll. Ist padString zu lang, um innerhalb von targetLength zu bleiben, wird er am Ende abgeschnitten. Der Standardwert ist das Leerzeichen (U+0020).

Rückgabewert

Typ
String
Beschreibung
Ein String mit der angegebenen targetLength, bei dem padString am Anfang angewendet wurde.

Beispiele

Verwendung von String.prototype.padStart()

"abc".padStart(10); // "       abc"
"abc".padStart(10, "foo"); // "foofoofabc"
"abc".padStart(6, "123465"); // "123abc"
"abc".padStart(8, "0"); // "00000abc"
"abc".padStart(1); // "abc"

Zahlenumwandlung in String mit fester Breite

// JavaScript-Version von: (unsigned)
// printf "%0*d" width num
function leftFillNum(num, targetLength) {
  return num.toString().padStart(targetLength, "0");
}

const num = 123;
console.log(leftFillNum(num, 5)); // "00123"