Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła