File: File() コンストラクター
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
構文
js
new File(fileBits, fileName)
new File(fileBits, fileName, options)
引数
fileBits-
反復可能オブジェクト、例えば
Array、ArrayBuffer、TypedArray、DataView、Blob、文字列、またはそのような要素を混合させたものを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