Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła