Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

ErrorEvent.error a ErrorEvent.message: hodnota chyby a chybové hlásenie

`message` obsahuje diagnostický text udalosti a `error` súvisiacu hodnotu JavaScriptu. Táto hodnota nemusí byť objektom `Error`.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

new ErrorEvent(type)
new ErrorEvent(type, { message, error })
event.message
event.error

ErrorEvent je rozhranie webovej platformy, nie vstavaný typ ECMAScriptu 2024. Na inštancii event.message vracia reťazec opisujúci problém a event.error súvisiacu hodnotu JavaScriptu. Obe vlastnosti sú len na čítanie. error môže obsahovať objekt Error, primitívnu hodnotu ako 0, null alebo undefined. Nepredpokladajte, že hodnota má vlastné chybové hlásenie alebo výpis zásobníka volaní.

new ErrorEvent(type, options) inicializuje obe vlastnosti nezávisle. Podľa štandardu HTML má vynechané message predvolenú hodnotu "" a vynechané error hodnotu undefined. Ak je odovzdanou hodnotou objekt Error, event.error.message patrí tomuto objektu a nemusí sa zhodovať s event.message.

Keď prehliadač nahlási na okne nezachytenú výnimku skriptu, poslucháč zaregistrovaný pomocou window.addEventListener("error", handler) dostane jeden objekt ErrorEvent. Pre tú istú udalosť dostane window.onerror päť pozičných argumentov: (message, source, lineno, colno, error). Nie každá udalosť error je typu ErrorEvent: pri zlyhaní načítania zdroja na prvku nie sú tieto vlastnosti zaručené. Nespracované zamietnutie prísľubu môže prehliadač nahlásiť samostatnou udalosťou unhandledrejection s vlastnosťou reason. Túto udalosť nevyvolá, ak sú chyby skriptu potlačené alebo ak sa zamietnutie spracuje pred nahlásením.

Keď sú podrobnosti chyby klasického skriptu skryté, napríklad pri skripte z iného pôvodu načítanom bez CORS, hlásenie obsahuje "Script error." v message a null v error. Text používajte na diagnostiku, nie ako stabilný kód chyby. Mimo prehliadača overte, či prostredie poskytuje ErrorEvent.

Príklady

{
  // 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);
}

Výsledok

Validation failed
true
Invalid input

Spustite kód v Node.js 24 alebo v konzole prehliadača. Ak prostredie neposkytuje natívny `ErrorEvent`, príklad použije lokálnu náhradu, ktorá napodobňuje iba obe uvedené vlastnosti. Kód vytvorí syntetickú udalosť bez vyvolania výnimky alebo odoslania udalosti. Riadok `true` potvrdzuje, že ide o ten istý objekt; prvý a posledný riadok ukazujú odlišné hlásenia.

Súvisiace lekcie

  • JavaScript · Lekcia 23 · Pokročilá · Verzia: 4

Zdroje