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

inflateRawSyncメソッドは、Node.jsのzlibモジュールが提供する機能の一つで、Deflateアルゴリズムによって圧縮されたデータを同期的に展開（解凍）するメソッドです。特に、圧縮データがzlibヘッダーやトレーラーを含まない「raw（生）」のDeflate形式である場合に利用されます。このメソッドは、圧縮された形式のBufferを引数として受け取り、その内容を元の非圧縮状態のBufferとして返します。

このメソッドの最大の特徴は、同期的に処理が実行される点にあります。つまり、inflateRawSyncメソッドが呼び出されると、データの展開処理が完了するまで、Node.jsアプリケーションのメインスレッドはブロックされ、他のJavaScriptコードの実行が一時停止します。そのため、主に比較的小さなデータを扱う場合や、アプリケーションの起動時、設定ファイルのロード時など、処理のブロックがシステム全体に大きな影響を与えない状況での使用が推奨されます。大量のデータ展開や、高い並行性が求められるWebサーバーなどの環境では、アプリケーションの応答性を損なう可能性があるため、非同期版のzlib.inflateRawメソッドなど、適切な非同期APIの利用を検討することが重要です。これにより、システムのパフォーマンスと安定性を維持することができます。

Copy
1const zlib = require('zlib');
2
3// inflateRawSyncの入力となる圧縮された生データ（Buffer）を準備します。
4// 例として、文字列 "Hello Node.js!" をzlib.deflateRawSyncで圧縮します。
5const originalBuffer = Buffer.from('Hello Node.js!');
6const compressedBuffer = zlib.deflateRawSync(originalBuffer);
7
8// 圧縮された生データを同期的に解凍します。
9const decompressedBuffer = zlib.inflateRawSync(compressedBuffer);
10
11// 解凍されたBufferを文字列に変換して表示します。
12console.log(decompressedBuffer.toString());

buffer, options = {}

• buffer: Buffer | TypedArray | DataView | string: 圧縮されたデータを格納したバッファ。文字列の場合はUTF-8として扱われます。
• options: object = {}: 圧縮解除のオプションを指定するオブジェクト。以下のプロパティを持つことができます。
  • flush: number: 圧縮解除の完了状態を指定するフラグ。
  • finish: boolean: 圧縮解除の完了時にバッファをフラッシュするかどうかを指定するブーリアン値。

Buffer

圧縮されていないデータを格納したBufferオブジェクトが返されます。