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

createZstdDecompressメソッドは、Zstandard (Zstd) 形式で圧縮されたデータを伸長（解凍）するための変換ストリームを作成するメソッドです。このメソッドを呼び出すと、入力された圧縮データを逐次的に伸長し、その結果を変換されたデータとして出力するストリームインスタンスが返されます。

このストリームは、Node.jsの標準的なストリームAPIに準拠したDuplexストリームの一種であり、特にTransformストリームとして機能します。これにより、ファイルからの読み込み、ネットワークからのデータ受信など、様々な入力元からのZstd圧縮データを効率的に処理し、その場で伸長して他の出力先へ流すことが可能になります。例えば、fs.createReadStream()で圧縮ファイルを読み込み、このcreateZstdDecompressストリームを通して伸長し、fs.createWriteStream()で伸長されたファイルを書き出すといった一連のデータパイプラインを構築できます。stream.pipeline()関数を使用すると、エラー処理を含めた堅牢なパイプラインをより簡単に構築することも可能です。

createZstdDecompressメソッドは、オプション引数を受け入れることがあり、これによって伸長処理の挙動を詳細に設定できます。例えば、特定の辞書を使用する設定や、メモリ使用量を制限する設定などが考えられます。これにより、特定の環境や要件に合わせた柔軟なZstd伸長処理を実現できます。処理中にエラーが発生した場合は、返されるストリームオブジェクトがerrorイベントを発行しますので、安全なアプリケーションを開発するためには、このイベントに対する適切なエラーハンドリングの実装が不可欠です。このメソッドは、Node.jsアプリケーションにおいてZstd圧縮データを効率的かつ信頼性高く扱うための重要な基盤となります。

Copy
1Object.createZstdDecompress(options);

options

• options: object: Zstd 圧縮解除処理のオプションを指定するオブジェクト
  • chunkSize: number: チャンクのサイズを指定します（デフォルト: 16384）。
  • dictionary: Buffer | DataView | ArrayBuffer | TypedArray | string: 辞書を指定します。
  • level: number: 圧縮レベルを指定します（デフォルト: 3）。
  • manifest: boolean: マニフェストの生成を有効にするかどうかを指定します（デフォルト: false）。
  • size: number: 圧縮データのサイズを指定します。
  • checksum: boolean: チェックサムの検証を有効にするかどうかを指定します（デフォルト: false）。

zlib.ZstdDecompress

Object.createZstdDecompress()メソッドは、Zstd圧縮されたデータを解凍するためのzlib.ZstdDecompressオブジェクトを生成して返します。このオブジェクトを使用することで、Zstd形式の圧縮データを展開できます。