CKTIS / JavaScript
String.prototype.trimStart() — usuwanie początkowych białych znaków
Metoda trimStart() zwraca tekst bez początkowych białych znaków i znaków końca wiersza zdefiniowanych przez ECMAScript. Nie zmienia oryginału ani znaków wewnątrz tekstu i na jego końcu.
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
string.trimStart()String.prototype.trimStart() usuwa najdłuższy początkowy ciąg znaków należących do zbiorów WhiteSpace lub LineTerminator w ECMAScript. Obejmuje to m.in. spacje, tabulatory, znaki nowego wiersza i spację nierozdzielającą U+00A0. Nie oznacza to wszystkich niewidocznych znaków Unicode: U+200B nie jest usuwany.
Wywołanie string.trimStart() nie przyjmuje parametrów i zwraca wartość typu string. Łańcuchy są niemutowalne, więc oryginał pozostaje niezmieniony; aby korzystać z wyniku, trzeba go zachować lub przekazać dalej. Znaki wewnętrzne i końcowe pozostają nietknięte. Pusty tekst oraz tekst złożony wyłącznie z usuwanych znaków dają "".
W odróżnieniu od trimStart(), trimEnd() usuwa takie znaki wyłącznie z końca, a trim() z obu stron. Nie można podać własnego zestawu znaków do usunięcia. Metoda jest generyczna: użyta przez String.prototype.trimStart.call(value) konwertuje dopuszczalny odbiornik na tekst; odbiorniki null i undefined powodują TypeError.
Metodę wprowadzono w ECMAScript 2019. trimLeft to starszy alias zgodnościowy; w nowym kodzie wybieraj trimStart. Specyfikacja języka nie jest tabelą obsługi przeglądarek: dostępność w środowisku docelowym sprawdzaj przez typeof String.prototype.trimStart === "function". Obecność Node 24 w repozytorium nie dowodzi obsługi w przeglądarce.
Przykłady
const text = "\t\n\u00A0Hello world ";
const result = text.trimStart();
console.log(JSON.stringify(result));
console.log(result.endsWith(" "));
console.log(text.startsWith("\t"));Wynik
"Hello world " true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.