CKTIS / JavaScript
String.prototype.trimEnd() — usuwanie końcowych białych znaków
trimEnd() zwraca tekst bez końcowych białych znaków i znaków końca wiersza. Jeśli tekst składa się wyłącznie z takich znaków, wynikiem jest pusty łańcuch. Oryginał pozostaje bez zmian.
Wersja: ECMAScript 2019. The main ECMAScript specification defines String.prototype.trimRight as a legacy alias whose initial value is the same function object as String.prototype.trimEnd.
Składnia
str.trimEnd()String.prototype.trimEnd() usuwa najdłuższy końcowy ciąg białych znaków i znaków końca wiersza, a wynik zwraca jako wartość typu string. Jeśli łańcuch zawiera znak, który nie należy do żadnej z tych grup, wszystko do ostatniego takiego znaku włącznie pozostaje bez zmian. Łańcuchy są niemutowalne: aby użyć wyniku, zapisz go lub przekaż dalej. Dla łańcucha złożonego wyłącznie z usuwanych znaków metoda zwraca pusty łańcuch.
Metoda nie przyjmuje parametrów określających usuwane znaki. Korzysta z zestawu WhiteSpace i LineTerminator z ECMAScript, obejmującego między innymi spację, tabulator, znaki końca wiersza i spację nierozdzielającą \u00A0. Nie usuwa dowolnych niewidocznych znaków ani wskazanego sufiksu. trimStart() działa na początku, a trim() na obu końcach.
Metoda jest generyczna. Przy wywołaniu przez call zgłasza TypeError, jeśli odbiorcą jest null lub undefined, jeszcze przed konwersją na string. Do pozostałych wartości stosuje operację ToString, która dla wartości prymitywnej typu Symbol również zgłasza TypeError.
trimEnd() należy do ECMAScript 2019, a nie do Web APIs. Specyfikacja języka nie jest tabelą zgodności przeglądarek; dla docelowego środowiska sprawdź dostępność, np. przez typeof String.prototype.trimEnd === "function". Samo używanie Node 24 w repozytorium nie potwierdza obsługi w przeglądarkach.
Przykłady
const original = " Ada Lovelace \t\n";
const result = original.trimEnd();
console.log(JSON.stringify(result));
console.log(result.length);
console.log(original.length);Wynik
" Ada Lovelace" 14 17
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.