KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

ErrorEvent.error en ErrorEvent.message: foutwaarde en foutmelding

`message` bevat de diagnostische tekst van de gebeurtenis. `error` bevat de bijbehorende JavaScript-waarde, die geen `Error`-object hoeft te zijn.

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

Syntax

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

ErrorEvent is een interface van het webplatform, geen ingebouwd type van ECMAScript 2024. Op een instantie geeft event.message een tekenreeks terug die het probleem beschrijft, en event.error de bijbehorende JavaScript-waarde. Beide eigenschappen zijn alleen-lezen. error kan een Error-object, een primitieve waarde zoals 0, null of undefined bevatten. Ga er niet van uit dat de waarde zelf een foutmelding of stacktrace heeft.

new ErrorEvent(type, options) initialiseert de twee eigenschappen onafhankelijk van elkaar. Volgens de HTML-standaard is de standaardwaarde voor een weggelaten message "" en voor een weggelaten error undefined. Als de opgegeven waarde een Error-object is, hoort event.error.message bij dat object en hoeft die tekst niet overeen te komen met event.message.

Als de browser een niet-afgevangen scriptexceptie op het venster meldt, ontvangt een listener die met window.addEventListener("error", handler) is geregistreerd één ErrorEvent. Voor dezelfde gebeurtenis ontvangt window.onerror vijf positionele argumenten: (message, source, lineno, colno, error). Niet elke error-gebeurtenis is een ErrorEvent: als een element een bron niet kan laden, zijn deze eigenschappen niet gegarandeerd. De browser kan een niet-afgehandelde afwijzing van een promise melden via de aparte gebeurtenis unhandledrejection, met de eigenschap reason. Die gebeurtenis wordt niet verstuurd als fouten van het script worden onderdrukt of als de afwijzing vóór de melding wordt afgehandeld.

Als de foutdetails van een klassiek script worden afgeschermd, bijvoorbeeld bij een zonder CORS geladen script van een andere origin, bevat het rapport "Script error." als message en null als error. Gebruik de tekst voor diagnose, niet als stabiele foutcode. Controleer buiten de browser of de runtime ErrorEvent aanbiedt.

Voorbeelden

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

Resultaat

Validation failed
true
Invalid input

Voer de code uit in Node.js 24 of in de browserconsole. Als er geen ingebouwde `ErrorEvent` beschikbaar is, gebruikt het voorbeeld een lokale vervanger die alleen de twee getoonde eigenschappen nabootst. De code maakt een synthetische gebeurtenis aan zonder een exceptie te gooien of de gebeurtenis te versturen. `true` bevestigt dat het om hetzelfde object gaat; de eerste en laatste regel tonen verschillende meldingen.

Gerelateerde lessen

  • JavaScript · Les 23 · Gevorderd · Versie: 4

Bronnen