String.prototype.padStart()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2017.

Die padStart()-Methode von String-Werten füllt diesen String mit einem anderen String (mehrfach, falls erforderlich) auf, bis der resultierende String die angegebene Länge erreicht. Das Auffüllen wird am Anfang dieses Strings angewendet.

Probieren Sie es aus

Syntax

js
padStart(targetLength)
padStart(targetLength, padString)

Parameter

targetLength

Die Länge des resultierenden Strings, nachdem der aktuelle str aufgefüllt wurde. Wenn der Wert kleiner oder gleich str.length ist, wird str unverändert zurückgegeben.

padString Optional

Der String, mit dem der aktuelle str aufgefüllt werden soll. Wenn padString zu lang ist, um innerhalb der targetLength zu bleiben, wird er am Ende abgeschnitten. Der Standardwert ist das Unicode-"Leerzeichen"-Zeichen (U+0020).

Rückgabewert

Ein String der angegebenen targetLength mit padString, angewendet vom Start.

Beispiele

Einfache Beispiele

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

Konvertierung auf feste Breite für String-Nummern

js
// JavaScript version of: (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"

Spezifikationen

Specification
ECMAScript Language Specification
# sec-string.prototype.padstart

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch