CKTIS / JavaScript
String.prototype.padStart — допълване на текст отляво
String.prototype.padStart допълва началото на низ до зададена дължина чрез повтаряне на запълващия текст и, когато е необходимо, съкращаването му. Не променя оригиналния низ и не съкращава низ, който вече е достатъчно дълъг. Дължината се измерва в UTF-16 кодови единици.
Версия: Introduced in ECMAScript 2017 (ES2017) as a standard-library method. Node.js 24 support does not establish browser support.
Синтаксис
str.padStart(maxLength[, fillString])String.prototype.padStart връща низ, допълнен отляво. Аргументът maxLength задава целевата дължина на целия резултат, а не броя знаци за добавяне. Оригиналният низ остава непроменен. Методът е полезен например за идентификатори с водещи нули; първо преобразувайте числата в низове.
Незадължителният аргумент fillString се повтаря до достигане на необходимата дължина на запълване. Излишъкът се премахва от края на запълването, а не от оригиналния низ. Ако fillString бъде пропуснат или се подаде undefined, се използва един интервал U+0020. Празно запълване "" оставя низа непроменен. Ако maxLength не надвишава дължината на низа, методът го връща без допълване или съкращаване.
maxLength се преобразува чрез ToLength: положителните дробни стойности се отрязват до цели числа, а отрицателните стойности и NaN стават нула. Дължината означава UTF-16 кодови единици, а не видими знаци или ширина на екрана. Съкращаването на запълването може да раздели сурогатна двойка, затова за такива идентификатори са подходящи прости ASCII символи за запълване. Извикването на метода с null или undefined като this предизвиква TypeError.
Методът е част от ECMAScript 2017 (ES2017), а не от Web APIs. Езиковата спецификация не определя кои версии на браузърите го поддържат; проверете typeof String.prototype.padStart === "function" в целевата среда. Наличието на Node 24 в хранилище не доказва поддръжка в браузърите.
Примери
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);Резултат
00042 ababa42 " 42" 42 42 42
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.