File: File() コンストラクター

メモ: この機能はウェブワーカー内で利用可能です。

File() コンストラクターは、新しい File オブジェクトのインスタンスを生成します。

構文

js
new File(fileBits, fileName)
new File(fileBits, fileName, options)

引数

fileBits

反復可能オブジェクト、例えば ArrayArrayBufferTypedArrayDataViewBlob、文字列、またはそのような要素を混合させたものを File 内に格納します。 なお、文字列は JavaScript の UTF-16 文字列ではなく、UTF-8 でエンコードされます。

fileName

文字列で、ファイル名またはファイルへのパスを表します。

options 省略可

ファイルのオプション属性を含むオプションオブジェクト。利用可能なオプションは以下の通りです。

type 省略可

ファイルの中に入るコンテンツの MIME タイプを表す文字列です。既定値は "" です。

endings 省略可

データがテキストの場合、コンテンツ内の改行文字 (\n) をどのように解釈するか。既定値である transparent は、改行文字を変更せずにblobにコピーします。改行文字をホストシステムのネイティブ規約に変換するには、値 native を指定します。

lastModified 省略可

UNIX 元期からのミリ秒単位で、ファイルが最後に更新された時刻を表す数値です。既定値は Date.now() です。

js
const file = new File(["foo"], "foo.txt", {
  type: "text/plain",
});

仕様書

Specification
File API
# file-constructor

ブラウザーの互換性

BCD tables only load in the browser

関連情報