KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

String.prototype.padEnd — het einde van een tekenreeks opvullen

String.prototype.padEnd vult het einde van een tekenreeks op tot een doellengte door een opgegeven tekenreeks te herhalen of standaard spaties te gebruiken. De oorspronkelijke tekenreeks blijft ongewijzigd en een tekenreeks die al lang genoeg is, wordt niet ingekort.

Versie: 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 geeft een tekenreeks terug die rechts is opgevuld tot lengte maxLength. Dit argument geeft de totale doellengte van het resultaat aan, niet het aantal tekens dat moet worden toegevoegd. De methode verandert het origineel niet. De methode maakt sinds de ECMAScript-editie van 2017 deel uit van ECMAScript; het is geen Web API. Alleen op basis van de specificatie kan ondersteuning in een bepaalde browser niet worden vastgesteld.

Als fillString is weggelaten of de waarde undefined heeft, wordt opgevuld met een spatie U+0020. Anders wordt de opvulwaarde omgezet naar een tekenreeks, herhaald en zo nodig aan het einde afgekapt. Een lege fillString voegt niets toe. Als maxLength niet groter is dan de lengte van de invoer, geeft de methode de tekenreeks ongewijzigd terug, zonder fillString om te zetten.

Op maxLength wordt ToLength toegepast: een positief fractioneel deel wordt verwijderd, terwijl negatieve waarden en NaN nul worden. De lengte wordt gemeten in UTF-16-code-eenheden, niet in zichtbare tekens of schermkolommen. Bij het afkappen van de opvulling kan een surrogaatpaar worden gesplitst. Deze methode garandeert daarom geen correcte uitlijning van willekeurige Unicode-tekst.

Het voorbeeld laat zien hoe opvulling wordt herhaald en afgekapt, hoe standaardspaties werken en welke twee gevallen geen opvulling opleveren. JSON.stringify maakt de grenzen van de tekenreeks zichtbaar, zodat afsluitende spaties kunnen worden geteld.

Voorbeelden

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);

Resultaat

"ID.-.-."
"ID  "
"ID"
"ID"
ID

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen