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

CKTIS / JavaScript

Error.message — text chybové zprávy

Vlastnost message instance Error obsahuje text zprávy bez názvu chyby. Zjistěte, jaký je rozdíl mezi error.message a error.toString() a co se stane, když zprávu vynecháte.

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

const error = new Error(message);
error.message

Error.message zde označuje vlastnost message instance chyby, ke které se přistupuje jako k error.message, nikoli statickou vlastnost konstruktoru Error. Patří do ECMAScriptu, nikoli do Web API.

Při volání new Error(message) s argumentem jiným než undefined použije konstruktor operaci ToString. Pouze pokud se převod podaří, uloží výsledek do vlastní vlastnosti message, která se nezahrnuje do výčtu vlastností (enumerable: false) a kterou lze přepisovat a konfigurovat. Například new Error(Symbol()) při převodu vyvolá výjimku TypeError, takže volání nevrátí žádnou instanci. Pokud argument vynecháte nebo je undefined, konstruktor vlastní vlastnost message nevytvoří; pokud prototyp zůstane nezměněný, čtení vrátí zděděnou vlastnost Error.prototype.message, jejíž počáteční hodnota je prázdný řetězec "".

error.message obsahuje pouze zprávu. Naproti tomu error.toString() u běžné chyby Error s neprázdnou zprávou spojí název a zprávu do podoby Error: Invalid input. Je-li zpráva prázdná, vrátí pouze název Error.

Chcete-li mít předvídatelné příklady, zadejte vlastní zprávu jako níže. Nezakládejte logiku programu na přesném znění zpráv vytvářených enginem: jejich text se může v různých implementacích lišit.

Příklady

const error = new Error("Invalid input");
console.log(error.message);
console.log(error.toString());
console.log(JSON.stringify(new Error().message));

Výsledek

Invalid input
Error: Invalid input
""

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