1berry/nodejs
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

doc: don't recommend domains for error handling

Browse Source 
Remove the suggestion to use domains for exception handling. Add clarity
to "unhandledException".

Fixes: https://github.com/nodejs/io.js/issues/2055
PR-URL: https://github.com/nodejs/io.js/pull/2056
Reviewed-By: Trev Norris <trev.norris@gmail.com>
Reviewed-By: Chris Dickinson <chris@neversaw.us>
This commit is contained in:
Benjamin Gruenbaum 2015-06-25 09:17:21 +03:00 committed by Trevor Norris
parent 9cd44bb2b6
commit 0f09b8db28
1 changed files with 5 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
doc/api/process.markdown
View File

@ -104,9 +104,6 @@ Example of listening for `uncaughtException`:
Note that `uncaughtException` is a very crude mechanism for exception Note that `uncaughtException` is a very crude mechanism for exception
handling. handling.
Don't use it, use [domains](domain.html) instead. If you do use it, restart
your application after every unhandled exception!
Do *not* use it as the io.js equivalent of `On Error Resume Next`. An Do *not* use it as the io.js equivalent of `On Error Resume Next`. An
unhandled exception means your application - and by extension io.js itself - unhandled exception means your application - and by extension io.js itself -
is in an undefined state. Blindly resuming means *anything* could happen. is in an undefined state. Blindly resuming means *anything* could happen.
@ -114,6 +111,11 @@ is in an undefined state. Blindly resuming means *anything* could happen.
Think of resuming as pulling the power cord when you are upgrading your system. Think of resuming as pulling the power cord when you are upgrading your system.
Nine out of ten times nothing happens - but the 10th time, your system is bust. Nine out of ten times nothing happens - but the 10th time, your system is bust.
`uncaughtException` should be used to perform synchronous cleanup before
shutting down the process. It is not safe to resume normal operation after
`uncaughtException`. If you do use it, restart your application after every
unhandled exception!
You have been warned. You have been warned.
## Event: 'unhandledRejection' ## Event: 'unhandledRejection'