Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Nazwa błędu: Error.prototype.name

Właściwość name obiektu błędu opisuje jego kategorię, np. Error lub TypeError. Można ją nadpisać, ale zmiana nazwy nie zmienia typu obiektu ani jego łańcucha prototypów.

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

error.name
error.name = "CustomError"

Hasło Error.name dotyczy tutaj nazwy instancji błędu: odczytuj ją jako error.name. Właściwość jest zdefiniowana na Error.prototype i ma początkową wartość "Error". Typy takie jak TypeError udostępniają własne nazwy na swoich prototypach. Dosłowne wyrażenie Error.name odczytuje natomiast nazwę funkcji konstruktora — to inna właściwość.

name określa kategorię, a message opisuje konkretny problem. Metoda Error.prototype.toString() wykorzystuje obie właściwości; gdy obie są niepustymi napisami, wynikiem jest "name: message".

Właściwość Error.prototype.name jest zapisywalna, niewyliczalna i konfigurowalna. Przypisanie error.name = "ValidationError" zwykłej instancji tworzy jej własną właściwość. Nie tworzy nowego typu błędu ani nie zmienia łańcucha prototypów: obiekt nadal spełnia error instanceof Error. Sama nazwa nie stanowi więc dowodu typu obiektu.

Przykłady

const error = new Error("Invalid input");
console.log(error.name);
error.name = "ValidationError";
console.log(error.name);
console.log(error.message);
console.log(error.toString());
console.log(error instanceof Error);

Wynik

Error
ValidationError
Invalid input
ValidationError: Invalid input
true

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

Źródła