From d940b158439f627e1cb774952d84af7a60513e39 Mon Sep 17 00:00:00 2001
From: Dario Piotrowicz <dario.piotrowicz@gmail.com>
Date: Wed, 2 Apr 2025 10:50:36 +0100
Subject: [PATCH] doc: clarify `unhandledRejection` events behaviors in process
 doc

PR-URL: https://github.com/nodejs/node/pull/57654
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Jake Yuesong Li <jake.yuesong@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
---
 doc/api/process.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/api/process.md b/doc/api/process.md
index b1542e0be1e..9f72b88bf70 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -578,6 +578,10 @@ address such failures, a non-operational
 `resource.loaded`, which would prevent the `'unhandledRejection'` event from
 being emitted.
 
+If an `'unhandledRejection'` event is emitted but not handled it will
+be raised as an uncaught exception. This alongside other behaviors of
+`'unhandledRejection'` events can changed via the [`--unhandled-rejections`][] flag.
+
 ### Event: `'warning'`
 
 <!-- YAML