CKTIS / JavaScript
String.prototype.padEnd — Zeichenfolgen am Ende auffüllen
String.prototype.padEnd füllt das Ende einer Zeichenfolge durch Wiederholen einer angegebenen Zeichenfolge oder mit Leerzeichen bis zu einer Ziellänge auf. Die ursprüngliche Zeichenfolge bleibt unverändert, und eine bereits ausreichend lange Zeichenfolge wird nicht gekürzt.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
str.padEnd(maxLength[, fillString])String.prototype.padEnd gibt eine Zeichenfolge zurück, die rechts bis zur Länge maxLength aufgefüllt wurde. Dieses Argument gibt die Ziellänge des gesamten Ergebnisses an, nicht die Anzahl der hinzuzufügenden Zeichen. Die Methode verändert das Original nicht. Sie ist seit der ECMAScript-Ausgabe von 2017 Bestandteil von ECMAScript und keine Web API. Aus der Spezifikation allein lässt sich keine Unterstützung in einem bestimmten Browser ableiten.
Wenn fillString ausgelassen wird oder den Wert undefined hat, wird mit einem Leerzeichen U+0020 aufgefüllt. Andernfalls wird der Füllwert in eine Zeichenfolge umgewandelt, wiederholt und bei Bedarf am Ende abgeschnitten. Ein leeres fillString fügt nichts hinzu. Ist maxLength nicht größer als die Länge der Eingabe, gibt die Methode die Zeichenfolge unverändert zurück, ohne fillString umzuwandeln.
Auf maxLength wird ToLength angewendet: Ein positiver Nachkommateil wird verworfen, während negative Werte und NaN zu null werden. Die Länge wird in UTF-16-Codeeinheiten gemessen, nicht in sichtbaren Zeichen oder Bildschirmspalten. Beim Abschneiden der Auffüllung kann ein Surrogatpaar getrennt werden. Daher garantiert diese Methode keine korrekte Ausrichtung beliebiger Unicode-Texte.
Das Beispiel zeigt das Wiederholen und Abschneiden der Auffüllung, Standardleerzeichen und zwei Fälle ohne Auffüllung. JSON.stringify macht die Grenzen der Zeichenfolge sichtbar, sodass sich nachgestellte Leerzeichen zählen lassen.
Beispiele
const label = "ID";
console.log(JSON.stringify(label.padEnd(7, ".-")));
console.log(JSON.stringify(label.padEnd(4)));
console.log(JSON.stringify(label.padEnd(1, "0")));
console.log(JSON.stringify(label.padEnd(7, "")));
console.log(label);Ergebnis
"ID.-.-." "ID " "ID" "ID" ID
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.