CKTIS / JavaScript
String.prototype.trimStart() — odstranění počátečních mezer
trimStart() vrací text, ze kterého odstraní počáteční bílé znaky a ukončovače řádků definované standardem ECMAScript. Původní řetězec nemění a zachovává znaky uvnitř textu i na jeho konci.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
string.trimStart()String.prototype.trimStart() odstraní nejdelší počáteční posloupnost znaků patřících do množin WhiteSpace nebo LineTerminator v ECMAScriptu. Patří sem mimo jiné mezery, tabulátory, konce řádků a nezlomitelná mezera U+00A0. Neznamená to, že se odstraní všechny neviditelné znaky Unicode: U+200B se neodstraní.
Volání string.trimStart() nepřijímá žádné parametry a vrací hodnotu typu řetězec. Řetězce jsou neměnné, takže původní řetězec zůstává beze změny; chcete-li výsledek použít, uložte ho nebo ho předejte dál. Vnitřní a koncové znaky zůstávají nedotčené. Prázdný text i text složený pouze z odstraňovaných znaků vrací "".
Na rozdíl od trimStart() odstraňuje trimEnd() tyto znaky pouze na konci, zatímco trim() je odstraňuje na obou stranách. Nelze zadat vlastní sadu znaků k odstranění. Metoda je generická: při použití přes String.prototype.trimStart.call(value) převede přípustný přijímač na text; přijímače null a undefined způsobí TypeError.
Metoda byla zavedena v ECMAScriptu 2019. trimLeft je starší alias kvůli kompatibilitě; v novém kódu upřednostněte trimStart. Jazyková specifikace není tabulkou kompatibility prohlížečů: dostupnost v cílovém prostředí ověřte pomocí typeof String.prototype.trimStart === "function". Přítomnost Node 24 v repozitáři nedokazuje podporu v prohlížečích.
Příklady
const text = "\t\n\u00A0Hello world ";
const result = text.trimStart();
console.log(JSON.stringify(result));
console.log(result.endsWith(" "));
console.log(text.startsWith("\t"));Výsledek
"Hello world " true true
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.