【JavaScript ECMAScript】AsyncDisposableStack::AsyncDisposableStack.prototype[Symbol.asyncDispose]インスタンスメソッドの使い方

AsyncDisposableStack.prototypeSymbol.asyncDisposeメソッドは、AsyncDisposableStackインスタンスに登録されたすべての非同期リソースを、安全かつ確実に解放するために実行されるメソッドです。この特別なシンボル名を持つメソッドは、JavaScriptの新しい構文であるawait usingと組み合わせて使用されることを想定しており、対象のオブジェクトがスコープを抜ける際に自動的に非同期の片付け処理を実行する役割を担います。

具体的には、AsyncDisposableStackに積まれたリソース（例えば、開かれたファイル、ネットワーク接続、データベース接続など、使い終わったら閉じる必要があるもの）を、登録された順序とは逆の順序で一つずつ非同期に破棄します。この際、個々のリソースの破棄処理が非同期操作であっても適切に待機し、処理が完了するのを待ちます。もし、いずれかのリソースの破棄中にエラーが発生した場合、このメソッドはそれらのエラーを収集し、すべてのリソースの解放を試みた後にAggregateErrorとしてそれらのエラーをまとめてスローします。これにより、部分的なエラーがあっても残りのリソースの解放が試みられ、リソースリークのリスクを最小限に抑えることができます。

このメソッドを実装することで、開発者は非同期リソースのライフサイクル管理をよりシンプルかつ堅牢に行うことが可能になり、手動での複雑なエラーハンドリングやリソース解放の記述を減らすことができます。

Copy
1const myAsyncDisposableStack = new AsyncDisposableStack();
2await myAsyncDisposableStack[Symbol.asyncDispose]();

引数なし

引数はありません

Promise<void>

このメソッドは、AsyncDisposableStack のリソースを非同期的にクリーンアップした結果を示す Promise<void> を返します。Promise は、すべての非同期クリーンアップ操作が完了したときに解決されます。