doc: document diverging MessagePort.onmessage handling

nodejs · Mar 10, 2019 · 77f6b8c · 77f6b8c
1 parent 060b524
commit 77f6b8c
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/doc/api/worker_threads.md b/doc/api/worker_threads.md
@@ -319,6 +319,9 @@ listeners are attached.
 
 This method exists for parity with the Web `MessagePort` API. In Node.js,
 it is only useful for ignoring messages when no event listener is present.
+Node.js also diverges in its handling of `.onmessage`. Setting it will
+automatically call `.start()`, but unsetting it will let messages queue up
+until a new handler is set or the port is discarded.
 
 ### port.unref()
 <!-- YAML