File API
File() 构造函数创建新的 File 对象实例。
语法
new File(fileBits, fileName)
new File(fileBits, fileName, options)
参数
fileBits- : 一个可迭代对象,例如一个具有 ArrayBuffer、TypedArray、DataView、Blob、字符串或任何此类元素的组合的Array,将被放入 File 内。请注意,这里的字符串被编码为 UTF-8,与通常的 JavaScript UTF-16 字符串不同。
fileName- : 表示文件名或文件路径的字符串。
options- : 包含文件可选属性的选项对象。可用选项如下:
type- : 表示将放入文件的内容的 MIME 类型的字符串。默认值为
""。
- : 表示将放入文件的内容的 MIME 类型的字符串。默认值为
endings- : 如果数据是文本,如何解释内容中的换行符(
\n)。默认值transparent将换行符复制到 blob 中而不更改它们。要将换行符转换为主机系统的本机约定,指定值为native。
- : 如果数据是文本,如何解释内容中的换行符(
lastModified- : 一个数字,表示 Unix 时间纪元与文件上次修改时间之间的毫秒数。默认值为调用 Date.now() 返回的值。
- : 包含文件可选属性的选项对象。可用选项如下:
示例
const file = new File(["foo"], "foo.txt", {
type: "text/plain",
});
规范
浏览器兼容性
参见
- FileReader
- Blob
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
