worker: make Worker async disposable

jasnell · aduh95 · commit 8dbc6b210f8e · 2025-07-28T11:07:43.000+02:00
PR-URL: #58385 Backport-PR-URL: #58455 Reviewed-By: LiviaMedeiros <livia@cirno.name> Reviewed-By: Anna Henningsen <anna@addaleax.net> Reviewed-By: Matteo Collina <matteo.collina@gmail.com> Reviewed-By: Daeyeon Jeong <daeyeon.dev@gmail.com> Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
diff --git a/doc/api/worker_threads.md b/doc/api/worker_threads.md
@@ -1846,6 +1846,14 @@ Calling `unref()` on a worker allows the thread to exit if this is the only
 active handle in the event system. If the worker is already `unref()`ed calling
 `unref()` again has no effect.
 
+### `worker[Symbol.asyncDispose]()`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+Alias for [`worker.terminate()`][].
+
 ## Notes
 
 ### Synchronous blocking of stdio
diff --git a/lib/internal/worker.js b/lib/internal/worker.js
@@ -58,7 +58,7 @@ const {
 const { createMainThreadPort, destroyMainThreadPort } = require('internal/worker/messaging');
 const { deserializeError } = require('internal/error_serdes');
 const { fileURLToPath, isURL, pathToFileURL } = require('internal/url');
-const { kEmptyObject } = require('internal/util');
+const { kEmptyObject, SymbolAsyncDispose } = require('internal/util');
 const { validateArray, validateString } = require('internal/validators');
 const {
   throwIfBuildingSnapshot,
@@ -406,6 +406,10 @@ class Worker extends EventEmitter {
     });
   }
 
+  async [SymbolAsyncDispose]() {
+    await this.terminate();
+  }
+
   ref() {
     if (this[kHandle] === null) return;
 
