База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници