refactor: Make executeSafePromise work in browsers without polyfills

[mondoreale]

This pull request updates the executeSafePromise utility to improve its error handling across different environments. The main enhancement is more robust detection of whether the code is running in Node/Electron or in a browser, and handling fatal promise rejections appropriately in each case.

Changes

Improvements to error handling and environment detection:

• Updated the documentation for executeSafePromise to clarify that in Node/Electron, the process exits on fatal errors, while in browsers, an unhandled error is thrown.

• Improved environment detection by explicitly checking if process is defined before calling process.exit, ensuring compatibility with browser environments.

• In browser environments, changed the thrown error to use the cause property for proper error chaining, aligning with modern JavaScript error handling best practices.

Future steps

We may want to improve test coverage on this. I've tried but karma doesn't let it slide so easily.

[Copilot]

Pull request overview

This PR refactors the executeSafePromise utility to improve cross-platform compatibility, specifically making it work in browser environments without requiring polyfills. The key improvements focus on robust environment detection and proper error handling for both Node/Electron and browser contexts.

Key changes:

• Enhanced environment detection by checking if process is defined before attempting to call process.exit()
• Updated browser error handling to use the cause property for proper error chaining, following modern JavaScript standards
• Improved documentation to clarify behavior differences between Node/Electron and browser environments

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

@mondoreale I've opened a new pull request, #3311, to work on those changes. Once the pull request is ready, I'll request review from you.

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ mondoreale
❌ Copilot
_{You have signed the CLA already but the status is still pending? Let us recheck it.}