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 diese Zeichenkette mit einer anderen Zeichenkette (mehrfach, falls notwendig) auf, bis die resultierende Zeichenkette die angegebene Länge erreicht. Das Auffüllen erfolgt am Anfang dieser Zeichenkette.

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 der resultierenden Zeichenkette, sobald der aktuelle str aufgefüllt wurde. Wenn der Wert kleiner oder gleich str.length ist, wird str unverändert zurückgegeben.

padString Optional

Die Zeichenkette, mit der der aktuelle str aufgefüllt wird. Wenn padString zu lang ist, um in die targetLength zu passen, wird es am Ende abgeschnitten. Der Standardwert ist das Unicode-Leerzeichen (U+0020).

Rückgabewert

Eine String mit der angegebenen targetLength, wobei padString vom Anfang angewendet wurde.

Beispiele

Grundlegende 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"

Umwandlung von Zahlen in Zeichenketten mit fester Breite

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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
padStart

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch