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

pathToFileURLメソッドは、オペレーティングシステムに依存するファイルシステムのパス文字列を、Web標準のfile:スキーマを持つURLオブジェクトに変換するメソッドです。コンピュータ上のファイルやディレクトリの場所を示すローカルパス（例えば、Windows環境のC:\Users\user\document.txtや、Linux/macOS環境の/home/user/document.txtなど）を、統一されたURL形式（例えば、file:///C:/Users/user/document.txtやfile:///home/user/document.txt）に変換するために利用されます。

この変換は、Node.jsの新しいAPIやWeb標準のAPIがファイルシステム上のリソースを扱う際に、URL形式を要求する場合に特に重要です。例えば、ESモジュールをローカルファイルから動的にインポートするimport()文や、fetch() APIなどでローカルファイルを読み込む際に、file:スキーマのURLが必要となります。

pathToFileURLメソッドを使用することで、開発者はWindows、macOS、Linuxといった異なるオペレーティングシステム間でのパス表記の差異を意識することなく、標準的なURL形式でファイルパスを扱うことができます。これにより、アプリケーションのクロスプラットフォーム互換性が向上し、コードの移植性が高まります。また、パスに含まれる特殊文字も適切にURLエンコードされるため、安全かつ正確にファイルパスをURLへ変換することが可能です。

Copy
1import { pathToFileURL } from 'url';
2
3const filePath = '/home/user/project/data.json';
4const fileUrl = pathToFileURL(filePath);
5
6console.log(fileUrl.href);

path

• path: string: ファイルシステム上のファイルまたはディレクトリのパス

URL

pathToFileURL メソッドは、指定されたファイルパスを URL オブジェクトとして返します。これは、ローカルファイルシステム上のリソースを Uniform Resource Identifier (URI) として扱うために使用されます。