CKTIS / JavaScript
String.prototype.padEnd — допълване на края на низ
String.prototype.padEnd допълва края на низ до зададена дължина, като повтаря посочен низ или използва интервали по подразбиране. Не променя оригиналния низ и не скъсява низ, който вече е достатъчно дълъг.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
str.padEnd(maxLength[, fillString])String.prototype.padEnd връща низ, допълнен отдясно до дължина maxLength. Този аргумент задава общата целева дължина на резултата, а не броя знаци за добавяне. Методът не променя оригинала. Той е част от ECMAScript от изданието от 2017 г.; не е Web API. Само спецификацията не установява поддръжка в конкретен браузър.
Ако fillString е пропуснат или има стойност undefined, допълването е с интервал U+0020. В противен случай стойността за допълване се преобразува в низ, повтаря се и при нужда се отрязва в края. Празен fillString не добавя нищо. Ако maxLength не надвишава дължината на входа, методът връща низа без промяна, без да преобразува fillString.
Към maxLength се прилага операцията ToLength: положителната дробна част се отхвърля, а отрицателните стойности и NaN стават нула. Дължината се измерва в UTF-16 кодови единици, а не във видими знаци или екранни колони. При отрязване на допълването може да се раздели сурогатна двойка, затова методът не гарантира правилно подравняване на произволен Unicode текст.
Примерът показва повтаряне и отрязване на допълването, интервали по подразбиране и два случая без допълване. JSON.stringify прави границите на низа видими, за да могат да се преброят крайните интервали.
Примери
const label = "ID";
console.log(JSON.stringify(label.padEnd(7, ".-")));
console.log(JSON.stringify(label.padEnd(4)));
console.log(JSON.stringify(label.padEnd(1, "0")));
console.log(JSON.stringify(label.padEnd(7, "")));
console.log(label);Резултат
"ID.-.-." "ID " "ID" "ID" ID
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.