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

CKTIS / JavaScript

String.prototype.substring — извличане на част от низ

substring() връща частта от низ между start и end, без да включва end. Не променя оригиналния низ, ограничава индексите до дължината му и разменя границите, ако са в обратен ред.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

str.substring(start, end)

String.prototype.substring връща примитивен низ, без да променя оригинала. Индексите започват от нула: start се включва, а end не се включва. Ако end бъде пропуснат или се подаде undefined, се използва краят на низа; ако start бъде пропуснат, се използва нула.

Аргументите се преобразуват в числа, а дробните им части се отрязват към нулата. NaN и отрицателните стойности стават нула; стойностите над дължината на низа се ограничават до нея. След това методът разменя границите, ако start е по-голям от end. Равни граници дават "".

За разлика от slice(), отрицателните индекси не броят назад от края, а разменените граници не налагат празен резултат. Индексите се отнасят до UTF-16 кодови единици, а не до цели видими знаци; разделянето на сурогатна двойка може да върне непълен знак.

Това е метод от стандартната библиотека на ECMAScript, а не Web API. Примерът показва диапазон, разменени граници, отрицателен индекс, пропуснат end и празен резултат.

Примери

const text = "JavaScript";
console.log(text.substring(4, 10));
console.log(text.substring(10, 4));
console.log(text.substring(-3, 4));
console.log(text.substring(4));
console.log(JSON.stringify(text.substring(4, 4)));

Резултат

Script
Script
Java
Script
""

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

Източници