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

fileURLToPathBufferメソッドは、ファイルシステム上のリソースを示すfile://プロトコル形式のURLを、オペレーティングシステムが直接認識できるファイルパスの形式に変換し、その結果をBufferオブジェクトとして返すメソッドです。

このメソッドは、Node.jsでファイルシステム操作を行う際に、URL形式で指定されたファイルの場所を、fsモジュールなどのファイルシステムAPIが期待するパス形式に変換する必要がある場面で特に有用です。一般的なfileURLToPath関数が変換後のパスを文字列で返すのに対し、fileURLToPathBufferはBufferで返します。これにより、パスのエンコーディングに関する低レベルな制御が必要な場合や、特定のファイルシステムAPIがBuffer形式のパス入力を要求する場合に、直接的にその要件を満たすことができます。

引数には、file://プロトコルで始まるURL文字列、またはURLオブジェクトを指定します。メソッドは、オペレーティングシステムに応じたパス形式（Windowsでは\区切り、POSIX環境では/区切り）で適切にエンコードされたBufferを戻り値として返します。この変換プロセスでは、パーセントエンコーディングのデコードや、異なるプラットフォーム間でのパス表現の調整が自動的に行われます。

ただし、引数として渡されたURLがfile://プロトコルではない場合や、URLの形式が不正な場合は、エラーがスローされるため、メソッドを使用する際には適切な入力値を与えることが重要です。このメソッドは、file://URLとファイルシステムパスとの間の相互運用性を高め、より柔軟なファイル操作を実現するための重要なツールの一つです。

Copy
1import { fileURLToPathBuffer } from 'url';
2
3const fileUrl = 'file:///path/to/example.txt';
4const pathBuffer = fileURLToPathBuffer(fileUrl);
5console.log(pathBuffer);

url

• url: URLオブジェクト: ファイルパスを表すURLオブジェクト

Buffer

fileURLToPathBufferメソッドは、指定されたURLをNode.jsのBufferオブジェクトに変換して返します。