【Node.js24.x】Object::transferableAbortController()メソッドの使い方

transferableAbortControllerメソッドは、非同期操作のキャンセルを制御するためのAbortControllerインスタンス、またはその関連オブジェクトを、異なる実行コンテキスト間で効率的に転送可能にする機能を提供または利用するためのメソッドです。

Node.jsのmodule大分類に属し、特にObjectクラスの文脈で用いられることが想定されます。このメソッドは、例えばWorker Threadsなどの並行処理環境において、あるスレッドで開始された非同期処理のキャンセルシグナルを、別のスレッドに渡して利用する場合に役立ちます。一般的なオブジェクトの深いコピーとは異なり、「転送可能（transferable）」なオブジェクトは、その所有権が元のコンテキストから新しいコンテキストへ移動するため、メモリコピーのオーバーヘッドを削減し、アプリケーションのパフォーマンス向上に寄与します。

具体的には、このメソッドを通じて得られるAbortControllerに関連するオブジェクトやそのシグナルは、メッセージパッシング時にシリアライズとデシリアライズのコストを抑えつつ、効率的にスレッド間でのキャンセルの意思疎通を可能にします。これにより、システムリソースの効率的な利用と、より応答性の高いアプリケーションの設計が可能になります。

Copy
1import { AbortController } from 'node:events';
2import { transferableAbortController } from 'node:util';
3
4const controller = new AbortController();
5const transferableController = transferableAbortController(controller);

引数なし

引数はありません

AbortController

TransferableAbortControllerオブジェクトを返します。このオブジェクトは、Web APIのAbortControllerと互換性があり、Transferableオブジェクトとしてワーカー間で転送可能です。