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.messageError.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.