CKTIS / JavaScript
ErrorEvent.error и ErrorEvent.message: стойност и съобщение за грешка
`message` съдържа диагностичния текст на събитието, а `error` — свързаната стойност в JavaScript, която не е задължително обект `Error`.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
new ErrorEvent(type)
new ErrorEvent(type, { message, error })
event.message
event.errorErrorEvent е интерфейс на уеб платформата, а не вграден тип в ECMAScript 2024. При дадена инстанция event.message връща низ, който описва проблема, а event.error — свързаната стойност в JavaScript. Двете свойства са само за четене. error може да съдържа обект Error, примитивна стойност като 0, null или undefined. Не приемай, че стойността има собствено съобщение или информация за стека на извикванията.
new ErrorEvent(type, options) инициализира двете свойства независимо. Според стандарта HTML при пропускане на message стойността по подразбиране е "", а при пропускане на error — undefined. Ако подадената стойност е обект Error, event.error.message принадлежи на този обект и не е задължително да съвпада с event.message.
Когато браузърът докладва неприхванато изключение от скрипт на прозореца, слушател, регистриран чрез window.addEventListener("error", handler), получава един обект ErrorEvent. За същото събитие window.onerror получава пет позиционни аргумента: (message, source, lineno, colno, error). Не всяко събитие error е от тип ErrorEvent: неуспешното зареждане на ресурс на даден елемент не гарантира наличието на тези свойства. Браузърът може да докладва необработено отхвърляне на обещание чрез отделно събитие unhandledrejection със свойство reason. Той не изпраща това събитие, ако грешките на скрипта са скрити или ако отхвърлянето бъде обработено преди известяването.
Ако подробностите за грешка в класически скрипт са скрити, например при скрипт от друг произход, зареден без CORS, докладът съдържа "Script error." в message и null в error. Използвай текста за диагностика, а не като стабилен код за грешка. Извън браузъра провери дали средата за изпълнение предоставя ErrorEvent.
Примери
{
// Use the native constructor when available; otherwise model only these two properties.
const ErrorEvent = globalThis.ErrorEvent ?? class extends Event {
#message;
#error;
constructor(type, { message = "", error } = {}) {
super(type);
this.#message = String(message);
this.#error = error;
}
get message() { return this.#message; }
get error() { return this.#error; }
};
const original = new Error("Invalid input");
const event = new ErrorEvent("error", {
message: "Validation failed",
error: original,
});
console.log(event.message);
console.log(event.error === original);
console.log(event.error.message);
}Резултат
Validation failed true Invalid input
Изпълни кода в Node.js 24 или в конзолата на браузър. Ако средата не предоставя вграден `ErrorEvent`, примерът използва локален заместител, който възпроизвежда само показаните две свойства. Кодът създава синтетично събитие, без да хвърля изключение и без да изпраща събитието. Редът `true` потвърждава, че това е същият обект; първият и последният ред показват различни съобщения.
Свързани уроци
- JavaScript · Урок 23 · Напреднало · Версия: 4