【JavaScript ECMAScript】DisposableStack::DisposableStack.prototype.disposedインスタンスアクセサプロパティの使い方

DisposableStack.prototype.disposedプロパティは、DisposableStackインスタンスが既に破棄された状態であるかどうかを示す真偽値を保持するプロパティです。DisposableStackは、開いたファイルやネットワーク接続といった、使用後に確実にクリーンアップが必要なリソースを管理するために導入されたJavaScriptの新しい機能です。このdisposedプロパティは、DisposableStackに登録された全てのリソースのクリーンアップが完了し、そのDisposableStack自身が破棄された状態になったときにtrueを返します。

具体的には、DisposableStackインスタンスのdispose()メソッドが明示的に呼び出された後や、await using構文などのブロックが終了し、自動的にリソースが解放された後には、このdisposedプロパティの値はtrueになります。インスタンスがまだ破棄されていない初期状態や、リソースがまだアクティブに管理されている間はfalseを返します。

このプロパティを利用する主な目的は、DisposableStackインスタンスの状態を安全に確認することにあります。例えば、既に破棄されたDisposableStackに対して、誤って新しいリソースを追加しようとすると、実行時エラーが発生する可能性があります。そのような不適切な操作を避けるために、事前にdisposedプロパティの値を確認することで、より堅牢で予測可能なコードを記述できます。このプロパティは読み取り専用であり、外部からその値を変更することはできません。

Copy
1const myStack = new DisposableStack();
2const isStackDisposed = myStack.disposed;

引数なし

引数はありません

boolean

DisposableStack.prototype.disposed は、この DisposableStack インスタンスが既に解放済みであるかどうかを示す真偽値（boolean）を返します。true であれば解放済み、false であれば解放されていない状態です。