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 angegebenen String (falls notwendig wiederholt und/oder abgeschnitten), sodass der resultierende String eine bestimmte Länge erreicht. Das Füllen erfolgt vom Anfang dieses Strings.

Probieren Sie es aus

const str1 = "5";

console.log(str1.padStart(2, "0"));
// Expected output: "05"

const fullNumber = "2034399002125581";
const last4Digits = fullNumber.slice(-4);
const maskedNumber = last4Digits.padStart(fullNumber.length, "*");

console.log(maskedNumber);
// Expected output: "************5581"

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 wird. Wenn padString zu lang ist, um innerhalb von targetLength zu bleiben, wird es vom Ende abgeschnitten. Der Standardwert ist das Leerzeichen (U+0020).

Rückgabewert

Ein String der angegebenen targetLength mit padString am Anfang angewendet.

Beispiele

Verwendung von String.prototype.padStart()

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 in eine feste Breite eines String-Nummers

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® 2026 Language Specification
# sec-string.prototype.padstart

Browser-Kompatibilität

Siehe auch