CKTIS / JavaScript
String.prototype.endsWith — проверка на края на низ
String.prototype.endsWith проверява дали даден низ завършва с посочения текст и връща true или false. Методът различава главни и малки букви, не променя низа и позволява да зададете по-ранна крайна позиция за проверката.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
str.endsWith(searchString[, endPosition])String.prototype.endsWith сравнява searchString с края на низа и връща true или false, без да променя оригинала. Сравнението различава главни и малки букви и работи с UTF-16 кодови единици, без Unicode нормализация. Това е метод от стандартната библиотека на ECMAScript, а не API на браузъра.
Незадължителният параметър endPosition задава изключителна крайна граница: методът проверява края на префикса до тази граница, а не подниз, започващ от нея. Ако аргументът бъде пропуснат или е undefined, се използва пълната дължина. След преобразуване в цяло число стойността се ограничава в диапазона от 0 до дължината на низа; отрицателните стойности не броят назад от края. Позициите се измерват в UTF-16 кодови единици.
При празен searchString методът връща true дори при граница 0, ако преобразуването на endPosition, когато е необходимо, завърши успешно. Преобразуването се извършва преди проверката за съвпадение: подаването на 0n като стойност на endPosition предизвиква TypeError дори при празен searchString. Аргументът searchString се преобразува в низ, така че ако бъде пропуснат, се използва текстът "undefined". Аргумент, разпознат като регулярен израз, причинява TypeError. Извикването на метода с null или undefined като стойност на this също причинява TypeError.
В примера границата 10 е непосредствено след report.txt, затова проверката за .txt връща true, въпреки че целият низ завършва с .bak. Проверката за .BAK връща false, защото главните и малките букви се различават.
Примери
const filename = "report.txt.bak";
console.log(filename.endsWith(".bak"));
console.log(filename.endsWith(".txt", 10));
console.log(filename.endsWith(".BAK"));
console.log(filename.endsWith("", 0));Резултат
true true false true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.