CKTIS / JavaScript
String.prototype.substring — wyodrębnianie fragmentu tekstu
substring() zwraca fragment tekstu między indeksami start i end, bez pozycji end. Nie zmienia oryginału, ogranicza indeksy do długości tekstu i zamienia je miejscami, jeśli są w odwrotnej kolejności.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
str.substring(start, end)String.prototype.substring zwraca prymitywną wartość tekstową bez zmiany oryginału. Indeksy liczy od zera: start jest włączony, a end wyłączony. Pominięcie end lub przekazanie undefined oznacza koniec tekstu; pominięcie start oznacza zero.
Argumenty są konwertowane na liczby, a części ułamkowe odrzucane w kierunku zera. NaN i wartości ujemne stają się zerem; wartości większe niż długość tekstu są do niej ograniczane. Następnie metoda zamienia granice miejscami, jeśli początek jest większy od końca. Równe granice dają "".
W przeciwieństwie do slice(), ujemne indeksy nie oznaczają odliczania od końca, a odwrócone granice nie wymuszają pustego wyniku. Indeksy dotyczą jednostek kodowych UTF-16, nie całych widocznych znaków; przecięcie pary surogatów może zwrócić niepełny znak.
To metoda standardowej biblioteki ECMAScript, nie Web API. Przykład pokazuje zakres, zamianę granic, ujemny indeks, pominięcie end i pusty wynik.
Przykłady
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)));Wynik
Script Script Java Script ""
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.