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

createGunzipメソッドは、Gzip形式で圧縮されたデータを解凍するための変換ストリーム（Gunzipストリーム）を作成し、返却するメソッドです。

このメソッドはNode.jsのzlibモジュールに属しており、ファイルやネットワーク経由でGzip圧縮されたデータを受け取り、それを元の非圧縮データに戻す際に不可欠な機能を提供します。特に、大量の圧縮データを扱う場合にその真価を発揮します。Node.jsのストリームAPIに基づいて設計されているため、データを一度にメモリ全体に読み込む必要がなく、効率的に少しずつ処理できます。これにより、システムのメモリ消費を抑えながら、大規模なファイルやデータストリームの解凍をスムーズに行うことが可能です。

createGunzipメソッドが生成するGunzipストリームは、両方向のストリームとして機能します。つまり、圧縮されたデータをストリームに書き込むことができ、その結果として解凍されたデータをストリームから読み出すことができます。これにより、パイプ操作 (.pipe()) を利用して、他のReadableStreamやWritableStreamと簡単に連結し、データ処理のパイプラインを構築することが可能になります。

オプションとして、引数にオブジェクトを渡すことで、Zlibエンジンの動作に関する詳細な設定を行うこともできます。例えば、エラー処理の挙動や、解凍に使用されるバッファサイズなどをカスタマイズできるため、特定の要件に合わせた柔軟な解凍処理を実装することが可能です。WebアプリケーションでGzip圧縮されたリソースを処理したり、圧縮されたバックアップファイルを展開したりするなど、様々なシステム開発の場面で利用される重要なメソッドです。

Copy
1import { createGunzip } from 'node:zlib';
2
3const gunzip = createGunzip();

options = {}

• options: object: Gunzipストリームのオプションを指定するオブジェクト。デフォルトは空オブジェクトです。

Gunzip

Object.createGunzip() メソッドは、gzip 圧縮されたデータを解凍するための Gunzip ストリームオブジェクトを生成して返します。