Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

String.prototype.padStart()

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2017 browserübergreifend verfügbar.

Die Methode padStart() von String-Werten füllt diese Zeichenfolge mit einer angegebenen Zeichenfolge auf (die bei Bedarf wiederholt und/oder gekürzt wird), sodass die resultierende Zeichenfolge eine bestimmte Länge hat. Die Auffüllung erfolgt am Anfang dieser Zeichenfolge.

Probieren Sie es aus

const str = "5";

console.log(str.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 Zeichenfolge, nachdem das aktuelle str aufgefüllt wurde. Ist der Wert kleiner oder gleich str.length, wird str unverändert zurückgegeben.

padString Optional

Die Zeichenfolge, mit der das aktuelle str aufgefüllt wird. Ist padString zu lang, um innerhalb von targetLength zu bleiben, wird es am Ende gekürzt. Der Standardwert ist das Leerzeichen (U+0020).

Rückgabewert

Ein String der angegebenen Länge targetLength, an dessen Anfang padString hinzugefügt wurde.

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"

Umwandlung von Zahlen in Zeichenfolgen 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

Spezifikation
ECMAScript® 2027 Language Specification
# sec-string.prototype.padstart

Browser-Kompatibilität

Siehe auch