Error Code Portal
Node.jsNode.jsError code

ERR_WORKER_HANDLE_NOT_TRANSFERABLE

worker handle not transferable

What does this code mean?

Code ERR_WORKER_HANDLE_NOT_TRANSFERABLE · An issue reported by Node.js.

Official explanation · Original text

An attempt was made to transfer a net.Socket, net.Server or net.BoundSocket to another thread via a worker_threads postMessage() call while it was not in a transferable state, for example because it had already started reading, had buffered data, or had already been adopted.

Troubleshooting and diagnostic links

First check that the document's product, version, and environment match your situation.

Source and terms of use

Errors | Node.js v26.13.1 Documentation ↗

Creator: Node.js contributors; Joyent, Inc. and other Node contributors
License: MIT License (Node.js documentation)
Checked on: 2026-11-12

Modifications: English prose extracted; whitespace normalized; Korean context and classified official links added. Python code examples not redistributed.

Source details · Original licenses and notices