Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

String.prototype.padStart — rellenar texto por la izquierda

String.prototype.padStart rellena el comienzo de una cadena hasta una longitud especificada repitiendo el relleno y, cuando hace falta, truncándolo. No modifica la cadena original ni acorta una que ya tenga longitud suficiente. La longitud se mide en unidades de código UTF-16.

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

Sintaxis

str.padStart(maxLength[, fillString])

String.prototype.padStart devuelve una cadena rellenada por la izquierda. El argumento maxLength indica la longitud objetivo del resultado completo, no el número de caracteres que se añadirán. La cadena original no cambia. El método resulta útil, por ejemplo, para identificadores con ceros iniciales; convierte primero los números en cadenas.

El argumento opcional fillString se repite hasta alcanzar la longitud de relleno necesaria. El exceso se elimina del final del relleno, no de la cadena original. Si se omite fillString o se pasa undefined, se usa un espacio U+0020. Un relleno vacío "" deja la cadena sin cambios. Si maxLength no supera la longitud de la cadena, el método la devuelve sin rellenarla ni truncarla.

maxLength se convierte mediante ToLength: las fracciones positivas se truncan a enteros, mientras que los valores negativos y NaN se convierten en cero. La longitud se refiere a unidades de código UTF-16, no a caracteres visibles ni al ancho en pantalla. Al truncar el relleno se puede dividir un par sustituto, así que los rellenos ASCII sencillos son adecuados para estos identificadores. Llamar al método con null o undefined como this provoca un TypeError.

El método pertenece a ECMAScript 2017 (ES2017), no a las Web APIs. La especificación del lenguaje no establece qué versiones de navegador lo admiten; comprueba typeof String.prototype.padStart === "function" en el entorno de destino. Que un repositorio incluya Node 24 no demuestra que haya compatibilidad con navegadores.

Ejemplos

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

Resultado

00042
ababa42
"  42"
42
42
42

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes