Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

unhandledrejection — neobravnavana zavrnitev Promise

Dogodek unhandledrejection sporoči zavrnitev Promise, ki ob obvestilu brskalnika še ni obravnavana. Razkrije Promise in razlog zavrnitve; namenjen je diagnostiki, ne nadomešča pa lokalne obravnave napak.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

window.addEventListener("unhandledrejection", (event) => { /* event.promise, event.reason */ });

unhandledrejection je dogodek spletne platforme, ki se kot PromiseRejectionEvent pošlje globalnemu objektu, na primer window. Ne gre za sintakso ECMAScript. event.promise označuje zavrnjeni Promise, event.reason pa vsebuje razlog zavrnitve — poljubno vrednost, ne nujno objekt Error.

Obvestilo je asinhrono: brskalnik upošteva obravnavalnike, dodane med obdelavo mikronalog, in pred pošiljanjem dogodka znova preveri stanje obravnave. Zato sam Promise.reject() ne zagotavlja dogodka. Pravočasno dodan .catch() ga lahko prepreči; obravnavalnik, dodan po obvestilu, lahko povzroči ločen dogodek rejectionhandled.

Dogodek je mogoče preklicati. event.preventDefault() prepreči privzeto poročanje o tej zavrnitvi v konzoli, vendar ne spremeni stanja Promise in ne nadomesti .catch() ali try/catch okoli await. Uporabite ga premišljeno, da ne bi prikrili napak. Ta mehanizem ni popoln dnevnik napak: sledenje je izpuščeno pri skriptih z zastavico muted errors, tudi v nekaterih primerih skriptov z drugega izvora.

Primer filtrira dogodke glede na identiteto Promise, izpiše razlog in odstrani poslušalnik. Zaženite ga kot skript na prazni strani brskalnika, ne v Node.js. To API določa HTML Living Standard; izdaja ECMAScript ali prisotnost Node 24 ne potrjuje podpore v brskalniku.

Primeri

(() => {
  let rejected;

  function report(event) {
    if (event.promise !== rejected) return;
    event.preventDefault();
    window.removeEventListener("unhandledrejection", report);
    console.log("unhandled:", event.reason);
  }

  window.addEventListener("unhandledrejection", report);
  rejected = Promise.reject("demo");
})();

Rezultat

unhandled: demo

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri