文件:File() 构造函数

注意:此功能在 Web Workers 中可用。

File() 构造函数创建一个新的 File 对象实例。

语法

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

参数

fileBits

一个 可迭代 对象,例如一个 Array,包含 ArrayBufferTypedArrayDataViewBlob、字符串或这些元素的混合,它们将被放入 File 中。请注意,这里的字符串使用 UTF-8 编码,与通常的 JavaScript UTF-16 字符串不同。

fileName

一个字符串,表示文件名或文件路径。

options 可选

一个包含文件可选属性的选项对象。可用的选项如下

type 可选

一个字符串,表示要放入文件的 MIME 类型。默认值为 ""

endings 可选

如果数据是文本,则如何解释内容中的换行符 (\n)。默认值为 transparent,将换行符复制到 blob 中而不会更改它们。要将换行符转换为主机系统的本机约定,请指定值 native

lastModified 可选

一个数字,表示从 Unix 时间纪元到文件最后修改时间之间的毫秒数。默认值为 Date.now()

示例

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

规范

规范
File API
# file-constructor

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅