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

transferableAbortSignalメソッドは、Objectクラスに属し、非同期処理のキャンセルメカニズムであるAbortSignalオブジェクトを、異なる実行コンテキスト間で安全かつ効率的に転送するための機能を提供するメソッドです。Node.js環境では、ファイルI/Oやネットワーク通信といった非同期操作の途中で、その処理を中止したい場合にAbortSignalが利用されます。このAbortSignalは、キャンセル要求が発生したことを監視している処理に通知し、安全に操作を中断することを可能にします。

特に、Worker Threadsのような並行処理を行う環境で、親スレッドから子スレッドへ、あるいはスレッド間でAbortSignalを共有する必要がある場合に、このtransferableAbortSignalメソッドが役立ちます。通常、スレッド間でオブジェクトを渡す際には、データはコピーされて渡されますが、transferableなオブジェクトはデータそのものの所有権が移動します。これにより、特に複雑なオブジェクトや頻繁な通信を伴う場合に、メモリ使用量を抑えつつ、データ転送のオーバーヘッドを削減し、パフォーマンスを向上させることができます。

このメソッドを利用することで、既存のAbortSignalを転送可能な形式に変換したり、あるいは転送を前提としたAbortSignalを生成したりすることが可能になります。例えば、メインスレッドで開始された時間のかかる処理を子Workerスレッドにオフロードし、その処理を途中でキャンセルしたい場合に、このメソッドで準備されたAbortSignalをpostMessageなどを介して子Workerに渡すことで、子Worker内で実行中の処理を親スレッドから効率的に中止させることができます。これにより、Node.jsアプリケーションにおける非同期処理の制御と並行処理の柔軟性が高まります。

Copy
1const originalSignal = new AbortController().signal;
2const transferableSignal = AbortSignal.transfer(originalSignal);

signal

• signal: AbortSignal: 処理を中断するためのシグナル

AbortSignal

transferableAbortSignal メソッドは、Transferable Objects として扱うことができる AbortSignal インスタンスを返します。これは、Web Worker 間でアボートシグナルを効率的に共有するために使用されます。