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

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.

Zdroje