diff --git a/doc/api/worker_threads.md b/doc/api/worker_threads.md
index 8d4c703f480de2..5152cc8c4d5708 100644
--- 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