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

isDestroyedメソッドは、Node.jsのStreamクラスのインスタンスにおいて、そのストリームが既に破棄されているかどうかを確認するメソッドです。Node.jsにおけるストリームとは、ファイルからのデータの読み込みやネットワークへのデータの書き込みなど、連続するデータの流れを処理するための抽象的なインターフェースです。

このメソッドは、対象のストリームが明示的にdestroy()メソッドを呼び出すことで破棄されたか、または内部的なエラーなどによって自動的に破棄された場合にtrueを返します。ストリームがまだアクティブであるか、または正常に終了した状態であればfalseを返します。一度破棄されたストリームは、それ以上のデータの読み込みや書き込み操作を受け付けなくなり、不正な操作を行うとエラーが発生する可能性があります。

システム開発において、ストリームの現在の状態を正確に把握することは非常に重要です。特に、ストリームのライフサイクルを管理する際や、破棄されたストリームに対して不適切な操作を行わないように制御する場面でisDestroyedメソッドは役立ちます。これにより、例えば、すでに使えなくなったストリームにデータを送信しようとするような無駄な処理や、予期せぬエラーの発生を防ぎ、アプリケーションの安定性と堅牢性を向上させることができます。

Copy
1const { Writable } = require('stream');
2
3const myStream = new Writable();
4
5// ストリームが破壊されているかを確認する
6const isDestroyedStatus = myStream.isDestroyed();

引数なし

引数はありません

boolean

このメソッドは、ストリームが破棄されているかどうかを示す真偽値（trueまたはfalse）を返します。ストリームが破棄されている場合はtrue、そうでない場合はfalseが返されます。