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.