Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

String.prototype.padStart — compléter une chaîne à gauche

String.prototype.padStart complète le début d’une chaîne jusqu’à une longueur donnée en répétant le texte de remplissage et, si nécessaire, en le tronquant. La chaîne d’origine reste inchangée et n’est jamais raccourcie si elle est déjà assez longue. La longueur est mesurée en unités de code UTF-16.

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

Syntaxe

str.padStart(maxLength[, fillString])

String.prototype.padStart renvoie une chaîne complétée à gauche. L’argument maxLength indique la longueur cible du résultat entier, et non le nombre de caractères à ajouter. La chaîne d’origine reste inchangée. Cette méthode est utile, par exemple, pour des identifiants avec des zéros en tête ; convertissez d’abord les nombres en chaînes.

L’argument facultatif fillString est répété pour obtenir la longueur de remplissage nécessaire. L’excédent est supprimé à la fin du remplissage, et non de la chaîne d’origine. Si fillString est omis ou si undefined est transmis, un espace U+0020 est utilisé. Un remplissage vide "" laisse la chaîne inchangée. Si maxLength ne dépasse pas la longueur de la chaîne, la méthode renvoie la chaîne sans la compléter ni la tronquer.

maxLength fait l’objet d’une conversion ToLength : les fractions positives sont tronquées à l’entier, tandis que les valeurs négatives et NaN deviennent zéro. La longueur correspond aux unités de code UTF-16, et non aux caractères visibles ni à la largeur à l’écran. La troncature du remplissage peut séparer une paire de substituts ; des remplissages ASCII simples conviennent donc à ces identifiants. Appeler la méthode avec null ou undefined comme this déclenche une TypeError.

Cette méthode fait partie d’ECMAScript 2017 (ES2017), et non des Web APIs. La spécification du langage ne précise pas les versions de navigateur qui la prennent en charge ; vérifiez typeof String.prototype.padStart === "function" dans l’environnement cible. La présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs.

Exemples

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

Résultat

00042
ababa42
"  42"
42
42
42

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources