diff --git a/doc/api/worker_threads.md b/doc/api/worker_threads.md index 56eaf3f1cb857c..245acb35806d92 100644 --- a/doc/api/worker_threads.md +++ b/doc/api/worker_threads.md @@ -356,6 +356,12 @@ added: v14.5.0 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()`