Spec-Zone.ru › JavaScript

String.prototype.padStart()

Базовая поддержка Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и в версиях браузеров. Она доступна во всех браузерах с апреля 2017 года.

Метод padStart() объекта String дополняет строку указанной строкой (повторяя и/или обрезая при необходимости) до достижения заданной длины. Дополнение применяется с начала строки.

Попробуйте

const str = "5";

console.log(str.padStart(2, "0"));
// Expected output: "05"

const fullNumber = "2034399002125581";
const last4Digits = fullNumber.slice(-4);
const maskedNumber = last4Digits.padStart(fullNumber.length, "*");

console.log(maskedNumber);
// Expected output: "************5581"

Синтаксис

padStart(targetLength)
padStart(targetLength, padString)

Параметры

targetLength
Длина результирующей строки после дополнения текущей str. Если значение меньше или равно str.length, то str возвращается без изменений.
padString Необязательный
Строка, которой будет дополнена текущая str. Если padString слишком длинная, чтобы остаться в пределах targetLength, она будет урезана с конца. По умолчанию используется символ пробела (U+0020).

Возвращаемое значение

Строка String указанной targetLength с padString, примененной в начале.

Примеры

Использование String.prototype.padStart()

"abc".padStart(10); // "       abc"
"abc".padStart(10, "foo"); // "foofoofabc"
"abc".padStart(6, "123465"); // "123abc"
"abc".padStart(8, "0"); // "00000abc"
"abc".padStart(1); // "abc"

Преобразование чисел в строки фиксированной ширины

// JavaScript version of: (unsigned)
// printf "%0*d" width num
function leftFillNum(num, targetLength) {
  return num.toString().padStart(targetLength, "0");
}

const num = 123;
console.log(leftFillNum(num, 5)); // "00123"

Спецификации

Спецификация
ECMAScript® 2027 Language Specification
# sec-string.prototype.padstart

Совместимость с браузерами

Настольные компьютеры Мобильные устройства Сервер
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on iOS Samsung Internet WebView Android WebView on iOS Bun Deno Node.js
padStart
57
15
48
44
10
57
48
43
10
7.0
57
10
1.0.0
1.0
8.0.0

См. также

  • Polyfill String.prototype.padStart в core-js
  • es-shims polyfill String.prototype.padStart
  • String.prototype.padEnd()

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padStart

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API