Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Error.message — treść komunikatu błędu

Właściwość message instancji Error przechowuje treść komunikatu bez nazwy błędu. Poznaj różnicę między error.message a error.toString() oraz zachowanie przy pominięciu komunikatu.

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

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

Error.message oznacza tutaj właściwość message instancji błędu, odczytywaną jako error.message, a nie statyczną właściwość konstruktora Error. To element standardu ECMAScript, nie interfejs Web API.

Przy wywołaniu new Error(message) z argumentem innym niż undefined konstruktor stosuje operację ToString. Tylko jeśli konwersja się powiedzie, zapisuje wynik we własnej, niewyliczalnej właściwości message, którą można zapisywać i konfigurować. Na przykład new Error(Symbol()) zgłasza TypeError podczas konwersji, więc wywołanie nie zwraca instancji. Przy pominięciu argumentu lub przekazaniu undefined konstruktor nie tworzy własnej właściwości message; przy niezmienionym prototypie odczyt zwraca odziedziczone Error.prototype.message, którego wartość początkowa to pusty ciąg "".

error.message zawiera sam komunikat. Natomiast error.toString() dla zwykłego Error z niepustym komunikatem łączy nazwę i komunikat w postaci Error: Invalid input. Gdy komunikat jest pusty, zwraca samą nazwę Error.

Do przewidywalnych przykładów podawaj własny komunikat, jak w przykładzie poniżej. Nie uzależniaj logiki programu od dokładnego brzmienia komunikatów generowanych przez silnik: ich treść może różnić się między implementacjami.

Przykłady

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

Wynik

Invalid input
Error: Invalid input
""

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła