Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.prototype.trim() — usuwanie białych znaków z końców tekstu

trim() zwraca tekst bez początkowych i końcowych białych znaków oraz znaków końca wiersza. Nie zmienia oryginału ani odstępów wewnątrz tekstu i nie przyjmuje argumentu określającego znaki do usunięcia.

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.trim()

String.prototype.trim() usuwa z obu końców tekstu znaki należące do zbiorów WhiteSpace i LineTerminator zdefiniowanych w ECMAScript. Zwraca wartość typu string; nie zmienia oryginału. Gdy cały tekst składa się z takich znaków, wynikiem jest pusty string "".

Usuwane są między innymi zwykłe spacje, tabulatory, znaki końca wiersza oraz spacja nierozdzielająca U+00A0. Nie oznacza to usuwania każdego niewidocznego znaku: spacja o zerowej szerokości U+200B pozostaje. Znaki wewnątrz tekstu również pozostają bez zmian.

Wywołuj metodę jako text.trim(). Nie ma parametru wyboru znaków, więc trim("x") nie usuwa liter x. W razie potrzeby zachowania wyniku przypisz go do zmiennej. Metoda jest generyczna: String.prototype.trim.call(123) zwraca "123", ale przekazanie null lub undefined jako this powoduje TypeError.

Jest to metoda standardowej biblioteki ECMAScript, a nie Web API. Specyfikacja języka nie jest tabelą zgodności przeglądarek; obecność Node.js w projekcie nie dowodzi obsługi w przeglądarce docelowej.

Przykłady

const text = "\t  Ada  Lovelace \n";
const trimmed = text.trim();
console.log(JSON.stringify(trimmed));
console.log(text === "\t  Ada  Lovelace \n");
console.log(JSON.stringify(" \t\n".trim()));

Wynik

"Ada  Lovelace"
true
""

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła