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

brotliDecompressメソッドは、Node.jsのzlibモジュールが提供する、Brotli形式で圧縮されたデータを非同期で解凍する処理を実行するメソッドです。

このメソッドは、圧縮されたデータをBuffer、DataView、またはUint8Array形式で入力として受け取ります。解凍処理が完了すると、指定されたコールバック関数を通じて結果が返されます。コールバック関数は、処理中にエラーが発生した場合はエラーオブジェクトを、成功した場合は解凍されたデータを含むBufferオブジェクトを引数として受け取ります。

オプション引数を使用することで、解凍処理の挙動を詳細に制御できます。例えば、maxOutputLengthオプションで出力データの最大長を設定し、メモリ使用量を制限したり、潜在的なセキュリティリスク（例えば、圧縮爆弾攻撃）からシステムを保護したりすることが可能です。

Brotli圧縮は、特にWebコンテンツの配信においてデータサイズを削減し、ネットワーク転送効率を高めるために広く利用されている高効率な圧縮アルゴリズムです。このbrotliDecompressメソッドは、ウェブサーバーからBrotliで圧縮されたコンテンツを受け取った際や、Node.jsアプリケーション内でBrotli圧縮データを扱う際に、効率的に元のデータへと戻す際に使用します。非同期で動作するため、大きなデータを解凍している間もNode.jsのメインスレッドがブロックされることなく、アプリケーションの応答性を維持できるという利点があります。システムエンジニアを目指す方にとって、データ圧縮と解凍は効率的なデータ処理や通信において不可欠な技術であり、このメソッドはその基礎となる重要なツールの一つです。

Copy
1import { brotliDecompress, brotliCompress } from 'node:zlib';
2import { Buffer } from 'node:buffer';
3
4async function exampleBrotliDecompression() {
5  const originalData = Buffer.from('Hello from Node.js Brotli Decompress!', 'utf8');
6
7  // brotliDecompressの入力データを用意するため、まず元のデータをBrotliで圧縮します。
8  // この部分は、brotliDecompressメソッドが実際に処理する圧縮データを作成するためのものです。
9  const compressedData = await brotliCompress(originalData);
10
11  try {
12    // brotliDecompressメソッドの基本的な構文例です。
13    // 引数としてBrotli形式で圧縮されたBufferを受け取り、解凍されたBufferをPromiseで返します。
14    const decompressedData = await brotliDecompress(compressedData);
15
16    console.log('Original data:', originalData.toString('utf8'));
17    console.log('Decompressed data:', decompressedData.toString('utf8'));
18  } catch (error) {
19    console.error('Brotli decompression failed:', error);
20  }
21}
22
23exampleBrotliDecompression();

buffer, opts, callback

• buffer: Buffer: Brotli圧縮されたデータを含むBufferオブジェクト
• opts: object: 圧縮解除のオプションを指定するオブジェクト (省略可能)
• callback: Function: 圧縮解除処理が完了した際に呼び出されるコールバック関数

Promise<Buffer>

Brotli形式で圧縮されたデータの非圧縮済みの内容を、BufferオブジェクトとしてPromiseで返します。