diff --git a/doc/api/worker_threads.md b/doc/api/worker_threads.md index f32c2c4cf5ecf1..e745b5aa799319 100644 --- a/doc/api/worker_threads.md +++ b/doc/api/worker_threads.md @@ -452,6 +452,12 @@ added: The `'messageerror'` event is emitted when deserializing a message failed. +Currently, this event is emitted when there is an error occurring while +instantiating the posted JS object on the receiving end. Such situations +are rare, but can happen, for instance, when certain Node.js API objects +are received in a `vm.Context` (where Node.js APIs are currently +unavailable). + ### `port.close()`