File 对象,FileList 对象,FileReader 对象

    最常见的使用场合是表单的文件上传控件(),用户选中文件以后,浏览器就会生成一个数组,里面是每一个用户选中的文件,它们都是 File 实例对象。

    上面代码中,file是用户选中的第一个文件,它是 File 的实例。

    浏览器原生提供一个File()构造函数,用来生成 File 实例对象。

    1. new File(array, name [, options])

    File()构造函数接受三个参数。

    • array:一个数组,成员可以是二进制对象或字符串,表示文件的内容。
    • name:字符串,表示文件名或文件路径。
    • options:配置对象,设置实例的属性。该参数可选。

    第三个参数配置对象,可以设置两个属性。

    • type:字符串,表示实例对象的 MIME 类型,默认值为空字符串。
    • lastModified:时间戳,表示上次修改的时间,默认为Date.now()

    下面是一个例子。

    实例属性和实例方法

    • File.lastModified:最后修改时间
    • File.name:文件名或文件路径
    • File.size:文件大小(单位字节)
    • File.type:文件的 MIME 类型
    1. var myFile = new File([], 'file.bin', {
    2. lastModified: new Date(2018, 1, 1),
    3. });
    4. myFile.name // "file.bin"
    5. myFile.size // 0
    6. myFile.type // ""

    上面代码中,由于myFile的内容为空,也没有设置 MIME 类型,所以size属性等于0,type属性等于空字符串。

    File 对象没有自己的实例方法,由于继承了 Blob 对象,因此可以使用 Blob 的实例方法slice()

    FileList对象是一个类似数组的对象,代表一组选中的文件,每个成员都是一个 File 实例。它主要出现在两个场合。

    • 文件控件节点(<input type="file">)的files属性,返回一个 FileList 实例。
    • 拖拉一组文件时,目标区的DataTransfer.files属性,返回一个 FileList 实例。

    上面代码中,文件控件的files属性是一个 FileList 实例。

    FileList 的实例属性主要是length,表示包含多少个文件。

    FileList 的实例方法主要是,用来返回指定位置的实例。它接受一个整数作为参数,表示位置的序号(从零开始)。但是,由于 FileList 的实例是一个类似数组的对象,可以直接用方括号运算符,即myFileList[0]等同于myFileList.item(0),所以一般用不到item()方法。

    浏览器原生提供一个FileReader构造函数,用来生成 FileReader 实例。

    1. var reader = new FileReader();

    FileReader 有以下的实例属性。

    • FileReader.error:读取文件时产生的错误对象
    • FileReader.readyState:整数,表示读取文件时的当前状态。一共有三种可能的状态,0表示尚未加载任何数据,1表示数据正在加载,2表示加载完成。
    • FileReader.result:读取完成后的文件内容,有可能是字符串,也可能是一个 ArrayBuffer 实例。
    • FileReader.onabort:abort事件(用户终止读取操作)的监听函数。
    • FileReader.onerror:error事件(读取错误)的监听函数。
    • FileReader.onload:load事件(读取操作完成)的监听函数,通常在这个函数里面使用result属性,拿到文件内容。
    • FileReader.onloadstart:loadstart事件(读取操作开始)的监听函数。
    • FileReader.onloadend:loadend事件(读取操作结束)的监听函数。
    • FileReader.onprogress:progress事件(读取操作进行中)的监听函数。

    下面是监听load事件的一个例子。

    上面代码中,每当文件控件发生变化,就尝试读取第一个文件。如果读取成功(load事件发生),就打印出文件内容。

    FileReader 有以下实例方法。

    • FileReader.abort():终止读取操作,readyState属性将变成2
    • FileReader.readAsArrayBuffer():以 ArrayBuffer 的格式读取文件,读取完成后result属性将返回一个 ArrayBuffer 实例。
    • FileReader.readAsBinaryString():读取完成后,result属性将返回原始的二进制字符串。
    • FileReader.readAsText():读取完成后,result属性将返回文件内容的文本字符串。该方法的第一个参数是代表文件的 Blob 实例,第二个参数是可选的,表示文本编码,默认为 UTF-8。

    下面是一个例子。

    1. /* HTML 代码如下
    2. <input type="file" onchange="previewFile()">
    3. <img src="" height="200">
    4. */
    5. function previewFile() {
    6. var preview = document.querySelector('img');
    7. var file = document.querySelector('input[type=file]').files[0];
    8. var reader = new FileReader();
    9. reader.addEventListener('load', function () {
    10. preview.src = reader.result;
    11. }, false);
    12. if (file) {
    13. reader.readAsDataURL(file);
    14. }