Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

String.prototype.trimEnd() — odstranění koncových bílých znaků

trimEnd() vrací řetězec bez koncových bílých znaků a znaků konce řádku. Pokud řetězec obsahuje jen takové znaky, výsledkem je prázdný řetězec. Původní řetězec se nemění.

Verze: 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.

Syntaxe

str.trimEnd()

String.prototype.trimEnd() odstraní nejdelší koncovou posloupnost bílých znaků a znaků konce řádku a vrátí výsledek jako hodnotu typu string. Pokud řetězec obsahuje znaky, které nepatří ani do jedné z těchto skupin, vše až po poslední takový znak včetně zůstane beze změny. Řetězce jsou neměnné: chcete-li výsledek použít, uložte nebo předejte vrácenou hodnotu. Obsahuje-li řetězec pouze znaky, které metoda může odstranit, vrátí prázdný řetězec.

Metoda nepřijímá parametry určující, které znaky se mají odstranit. Používá množiny WhiteSpace a LineTerminator ze specifikace ECMAScript, které zahrnují mimo jiné mezery, tabulátory, znaky konce řádku a nezalomitelnou mezeru \u00A0. Neodstraňuje libovolné neviditelné znaky ani zadanou příponu. trimStart() působí na začátku, zatímco trim() na obou koncích.

Metoda je generická. Při volání přes call vyvolá pro null nebo undefined jako hodnotu this výjimku TypeError ještě před převodem na řetězec. Na ostatní hodnoty this použije operaci ToString, která pro primitivní hodnotu typu Symbol rovněž vyvolá výjimku TypeError.

trimEnd() patří do ECMAScript 2019, nikoli do Web APIs. Specifikace jazyka není tabulka kompatibility prohlížečů; dostupnost v cílovém prostředí ověřte například pomocí typeof String.prototype.trimEnd === "function". Samotné používání Node 24 v repozitáři nepotvrzuje podporu v prohlížečích.

Příklady

const original = "  Ada Lovelace \t\n";
const result = original.trimEnd();

console.log(JSON.stringify(result));
console.log(result.length);
console.log(original.length);

Výsledek

"  Ada Lovelace"
14
17

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje