CKTIS / JavaScript
String.prototype.padStart — tekst aan de linkerkant aanvullen
String.prototype.padStart vult het begin van een tekenreeks tot een opgegeven lengte aan door de opvulling te herhalen en zo nodig af te breken. De oorspronkelijke tekenreeks blijft ongewijzigd en wordt niet ingekort als die al lang genoeg is. De lengte wordt gemeten in UTF-16-code-eenheden.
Versie: 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 geeft een links aangevulde tekenreeks terug. Het argument maxLength bepaalt de gewenste lengte van het volledige resultaat, niet het aantal toe te voegen tekens. De oorspronkelijke tekenreeks blijft ongewijzigd. De methode is bijvoorbeeld handig voor identificaties met voorloopnullen; zet getallen eerst om in tekenreeksen.
Het optionele argument fillString wordt herhaald tot de benodigde opvullengte is bereikt. Overtollige tekst wordt aan het einde van de opvulling verwijderd, niet van de oorspronkelijke tekenreeks. Als fillString wordt weggelaten of undefined wordt doorgegeven, wordt één spatie U+0020 gebruikt. Een lege opvulling "" laat de tekenreeks ongewijzigd. Als maxLength niet groter is dan de lengte van de tekenreeks, geeft de methode die zonder aanvulling of afbreking terug.
maxLength wordt omgezet met ToLength: positieve breuken worden afgekapt tot gehele getallen, terwijl negatieve waarden en NaN nul worden. Lengte betekent UTF-16-code-eenheden, niet zichtbare tekens of weergavebreedte. Het afbreken van de opvulling kan een surrogaatpaar splitsen; eenvoudige ASCII-opvulling is daarom geschikt voor zulke identificaties. De methode aanroepen met null of undefined als this veroorzaakt een TypeError.
De methode hoort bij ECMAScript 2017 (ES2017), niet bij de Web APIs. De taalspecificatie bepaalt niet welke browserversies de methode ondersteunen; controleer typeof String.prototype.padStart === "function" in de doelomgeving. De aanwezigheid van Node 24 in een repository bewijst geen browserondersteuning.
Voorbeelden
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);Resultaat
00042 ababa42 " 42" 42 42 42
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.