SDK 向けの子プロセスライフサイクルヘルパー。生成したプロセスを終了させ(Windows ではプロセスツリーへのフォールバックあり)、AbortSignal をプロセスへ結び付ける。
Methods
(static) bindAbort(proc, signalopt, onAbortopt) → {function}
AbortSignal を子プロセスへ結び付け、abort によってプロセスを停止させる。また、プロセスの終了またはエラー発生時にリスナーを自動的に後始末する。
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
proc | ChildProcess | 結び付ける対象のプロセス。 | |
signal | AbortSignal | <optional> | abort によりプロセスを終了させるシグナル。省略した場合は何もしないクリーンアップ関数が返る。 |
onAbort | function | <optional> | abort によりプロセスが停止された後に呼び出される任意のコールバック。 |
Returns:
すべてのリスナーを切り離すクリーンアップ関数。
- Type:
- function
(static) stop(proc) → {void}
子プロセスがまだ稼働中であれば終了させる。Windows では taskkill /T /F によってプロセスツリー全体を停止し、それ以外の環境や taskkill が失敗した場合は proc.kill() にフォールバックする。
Parameters:
| Name | Type | Description |
|---|---|---|
proc | ChildProcess | 停止するプロセス。 |
Returns:
- Type:
- void