CKTIS / JavaScript
String.prototype.slice — wyodrębnianie fragmentu tekstu
String.prototype.slice zwraca fragment tekstu od start włącznie do end wyłącznie, bez zmiany oryginału. Indeksy ujemne liczą od końca, a pominięcie end oznacza pobranie reszty tekstu.
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
text.slice(start, end)String.prototype.slice zwraca prymitywną wartość tekstową i nie zmienia oryginału. W text.slice(start, end) indeksy zaczynają się od zera: start należy do wyniku, a end już nie. Pominięte start oznacza 0; pominięte end lub undefined oznacza długość tekstu. Wywołanie text.slice() zwraca cały tekst.
Indeks ujemny jest liczony względem końca: -1 wskazuje ostatnią jednostkę kodową. Po przeliczeniu indeksy są ograniczane do zakresu od 0 do długości tekstu. Jeśli początek jest równy końcowi lub go przekracza, wynikiem jest "". W przeciwieństwie do substring, slice nie zamienia granic miejscami.
Argumenty indeksów podlegają konwersji liczbowej; części ułamkowe są odrzucane w kierunku zera, a NaN staje się 0. Indeksy odnoszą się do jednostek kodowych UTF-16, nie do znaków widocznych dla użytkownika. Cięcie może więc rozdzielić parę surogatów albo sekwencję tworzącą jeden widoczny znak.
To metoda standardu ECMAScript, nie interfejs Web API. Można ją pożyczyć przez String.prototype.slice.call(value, start, end): odbiorca jest konwertowany na tekst, ale null i undefined powodują TypeError.
Przykłady
const text = "JavaScript";
console.log(text.slice(0, 4));
console.log(text.slice(4));
console.log(text.slice(-6, -2));
console.log(JSON.stringify(text.slice(7, 2)));
console.log(text);Wynik
Java Script Scri "" JavaScript
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.