【Node.js24.x】File::File()関数の使い方

File関数は、Web標準APIの一部として、ファイルデータをプログラム的に表現するためのFileオブジェクトを生成する関数です。この関数は、通常、ユーザーのデバイスから選択されたファイルや、既存のBlobオブジェクトから派生したファイルを抽象化して扱います。

File関数は、新しいFileオブジェクトを生成する際に、主に三つの引数を受け取ります。第一引数のfileBitsには、ファイルの内容を示すデータの配列を指定します。これには文字列、Blobオブジェクト、ArrayBufferなどが含まれます。第二引数のfileNameには、そのファイルの名前を表す文字列を指定します。そして、第三引数のoptionsはオプションの引数で、ファイルのMIMEタイプを指定するtypeプロパティや、ファイルが最後に変更された日時をミリ秒単位で示すlastModifiedプロパティなどを含んだオブジェクトを渡すことができます。

生成されるFileオブジェクトは、Blobオブジェクトのすべての特性を継承しており、さらにnameプロパティを通じてファイルの名前を、lastModifiedプロパティを通じて最終更新日時を提供します。この関数は、主にWebアプリケーションにおけるファイルのアップロード処理や、クライアントサイドで動的にファイルを作成し操作する際に、既存のデータから新しいファイルオブジェクトを生成したい場合に利用されます。Node.js環境においても、Web標準APIとの互換性を提供するために、このFile関数が組み込まれています。

Copy
1const fileContent = ['This is the content of the new file.'];
2const fileName = 'myNewFile.txt';
3const fileOptions = { type: 'text/plain', lastModified: Date.now() };
4
5const myFile = new File(fileContent, fileName, fileOptions);

fileBits, fileName, options = {}

• fileBits: FileSystemBits: ファイルのコンテンツまたはファイルパスを含む、ファイルシステムに関連するデータ。
• fileName: string: 作成するファイルの名称。
• options: object = {}: ファイル作成に関する追加オプションの設定。

File

Fileクラスは、ファイルシステム上のファイルを表すオブジェクトを生成します。この関数は、新しく生成されたFileオブジェクトを返します。