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

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

構文

js
new File(bits, name)
new File(bits, name, options)

引数

bits

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

name

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

options 省略可

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

type

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

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

関連情報