WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

String.prototype.padStart — Text links auffüllen

String.prototype.padStart füllt den Anfang eines Strings durch Wiederholung und bei Bedarf Kürzung der Füllzeichen bis zu einer angegebenen Länge auf. Der ursprüngliche String bleibt unverändert und wird nicht gekürzt, wenn er bereits lang genug ist. Die Länge wird in UTF-16-Codeeinheiten gemessen.

Version: Introduced in ECMAScript 2017 (ES2017) as a standard-library method. Node.js 24 support does not establish browser support.

Syntax

str.padStart(maxLength[, fillString])

String.prototype.padStart gibt einen links aufgefüllten String zurück. Das Argument maxLength gibt die Ziellänge des gesamten Ergebnisses an, nicht die Anzahl der hinzuzufügenden Zeichen. Der ursprüngliche String bleibt unverändert. Die Methode ist beispielsweise für Kennungen mit führenden Nullen nützlich; wandle Zahlen zuerst in Strings um.

Der optionale Parameter fillString wird wiederholt, bis die erforderliche Fülllänge erreicht ist. Überschüssiges wird am Ende der Füllung entfernt, nicht am ursprünglichen String. Wird fillString weggelassen oder undefined übergeben, wird ein einzelnes Leerzeichen U+0020 verwendet. Eine leere Füllung "" lässt den String unverändert. Ist maxLength nicht größer als die Länge des Strings, gibt die Methode den String ohne Auffüllen oder Kürzen zurück.

maxLength wird mit ToLength konvertiert: Positive Bruchteile werden zu Ganzzahlen abgeschnitten, negative Werte und NaN werden zu null. Die Länge bezeichnet UTF-16-Codeeinheiten, nicht sichtbare Zeichen oder die Darstellungsbreite. Beim Kürzen der Füllung kann ein Surrogatpaar getrennt werden; für solche Kennungen eignen sich daher einfache ASCII-Füllzeichen. Wird die Methode mit null oder undefined als this aufgerufen, wird ein TypeError ausgelöst.

Die Methode gehört zu ECMAScript 2017 (ES2017), nicht zu den Web APIs. Die Sprachspezifikation legt nicht fest, welche Browserversionen sie unterstützen; prüfe typeof String.prototype.padStart === "function" in der Zielumgebung. Dass ein Repository Node 24 enthält, belegt keine Browserunterstützung.

Beispiele

const id = "42";
console.log(id.padStart(5, "0"));
console.log(id.padStart(7, "ab"));
console.log(JSON.stringify(id.padStart(4)));
console.log(id.padStart(1, "0"));
console.log(id.padStart(5, ""));
console.log(id);

Ergebnis

00042
ababa42
"  42"
42
42
42

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen