【Node.js24.x】Object::File()メソッドの使い方
Fileメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Fileメソッドは、Webアプリケーションなどでファイルを扱う際に、そのファイルを表現するオブジェクトを生成するために実行されるメソッドです。Node.jsバージョン24において、Web標準APIとの互換性向上が進められており、このFileメソッドもその一環として、ファイル操作をより標準的な方法で扱えるようにするために利用できます。
このメソッドは、ファイルの名前、MIMEタイプ、サイズ、そして最終更新日時といった基本的なファイル情報を含んだオブジェクトを作成します。これにより、JavaScriptコード内でファイルを具体的なデータとして参照し、アップロードや表示などの操作を行うことが可能になります。例えば、ユーザーがWebページ上のフォームからファイルを選択した場合、その選択されたファイルはFileオブジェクトとして扱われ、その情報を基に処理を進めることができます。
Fileメソッドによって生成されるFileオブジェクトは、Blobオブジェクトの一種であり、ファイルの内容をバイナリデータとして扱うための機能も提供します。Node.jsの従来のファイルシステム（fsモジュール）がサーバーサイドのファイルパスや内容を直接操作するのに対し、このFileメソッドは主に、クライアントサイドからサーバーサイドへ送信されるファイルデータや、ブラウザ環境で生成されるファイルを抽象的に表現する際に用いられます。特に、Web APIを利用したデータ連携において、ファイルデータの標準的な表現形式として重要な役割を果たします。
構文(syntax)
1new File(fileBits, fileName, options);
引数(parameters)
fileBits, fileName, options = {}
- fileBits: ArrayBuffer | TypedArray | DataView | Buffer | string: ファイルの内容を表すバイト列または文字列
- fileName: string: ファイル名
- options: object = {}: その他のオプションを指定するオブジェクト。利用可能なオプションは以下の通りです。
- type: string: ファイルのMIMEタイプ
- lastModified: number: ファイルの最終更新日時（ミリ秒単位のUNIXタイムスタンプ）
戻り値(return)
File
File メソッドは、指定されたパスのファイルを表す File オブジェクトを返します。この File オブジェクトを通じて、ファイルの読み書きなどの操作が可能になります。