js中FileReader()用法

本文介绍HTML5的FileReader API,详细讲解如何使用FileReader读取文件,包括读取文本、二进制码及DataURL,并展示了上传图片预览和带进度条上传的示例。
该文章已生成可运行项目,
				版权声明:本文为博主原创文章,请在转载时说明出处。					https://blog.youkuaiyun.com/jackfrued/article/details/8967667				</div>
							            <link rel="stylesheet" href="https://csdnimg.cn/release/phoenix/template/css/ck_htmledit_views-f57960eb32.css">
					<div class="htmledit_views" id="content_views">

HTML5定义了FileReader作为文件API的重要成员用于读取文件,根据W3C的定义,FileReader接口提供了读取文件的方法和包含读取结果的事件模型。


FileReader的使用方式非常简单,可以按照如下步骤创建FileReader对象并调用其方法:

1.检测浏览器对FileReader的支持

if(window.FileReader) {
    var fr = new FileReader();
    // add your code here
}
else {
    alert("Not supported by your browser!");
}

2. 调用FileReader对象的方法

FileReader 的实例拥有 4 个方法,其中 3 个用以读取文件,另一个用来中断读取。下面的表格列出了这些方法以及他们的参数和功能,需要注意的是 ,无论读取成功或失败,方法并不会返回读取结果,这一结果存储在 result属性中。

方法名 参数 描述
abort none 中断读取
readAsBinaryString file 将文件读取为二进制码
readAsDataURL file 将文件读取为 DataURL
readAsText file, [encoding] 将文件读取为文本

readAsText:该方法有两个参数,其中第二个参数是文本的编码方式,默认值为 UTF-8。这个方法非常容易理解,将文件以文本方式读取,读取的结果即是这个文本文件中的内容。
readAsBinaryString:该方法将文件读取为二进制字符串,通常我们将它传送到后端,后端可以通过这段字符串存储文件。
readAsDataURL:这是例子程序中用到的方法,该方法将文件读取为一段以 data: 开头的字符串,这段字符串的实质就是 Data URL,Data URL是一种将小文件直接嵌入文档的方案。这里的小文件通常是指图像与 html 等格式的文件。


3. 处理事件

FileReader 包含了一套完整的事件模型,用于捕获读取文件时的状态,下面这个表格归纳了这些事件。

事件 描述
onabort 中断时触发
onerror 出错时触发
onload 文件读取成功完成时触发
onloadend 读取完成触发,无论成功或失败
onloadstart 读取开始时触发
onprogress 读取中

文件一旦开始读取,无论成功或失败,实例的 result 属性都会被填充。如果读取失败,则 result 的值为 null ,否则即是读取的结果,绝大多数的程序都会在成功读取文件的时候,抓取这个值。

fr.onload = function() {
    this.result;
}


下面通过一个上传图片预览和带进度条上传来展示FileReader的使用。

`
<script type="text/javascript">
		function showPreview(source) {
			var file = source.files[0];
			if(window.FileReader) {
				var fr = new FileReader();
				fr.onloadend = function(e) {
					document.getElementById("portrait").src = e.target.result;
				};
				fr.readAsDataURL(file);
			}
		}
	</script>
 
<input type="file" name="file" onchange="showPreview(this)" />
<img id="portrait" src="" width="70" height="75">

`

如果要限定上传文件的类型,可以通过文件选择器获取文件对象并通过type属性来检查文件类型

if(!/image\/\w+/.test(file.type)){
    alert("请确保文件为图像类型");
    return false;
}

不难发现这个检测是基于正则表达式的,因此可以进行各种复杂的匹配,非常有用。

如果要增加一个进度条,可以使用HTML 5的progress标签,通过下面的代码实现。

<form>
    <fieldset>
        <legend>分度读取文件:</legend>
        <input type="file" id="File" />
        <input type="button" value="中断" id="Abort" />
        <p>
            <label>读取进度:</label><progress id="Progress" value="0" max="100"></progress>
        </p>
        <p id="Status"></p>
    </fieldset>
</form>

var h = {
    init: function() {
        var me = this;
         
        document.getElementById('File').onchange = me.fileHandler;
        document.getElementById('Abort').onclick = me.abortHandler;
         
        me.status = document.getElementById('Status');
        me.progress = document.getElementById('Progress');
        me.percent = document.getElementById('Percent');
         
        me.loaded = 0;
        //每次读取1M
        me.step = 1024 * 1024;
        me.times = 0;
    },
    fileHandler: function(e) {
        var me = h;
         
        var file = me.file = this.files[0];
         
        var reader = me.reader = new FileReader();
         
        //
        me.total = file.size;
         
        reader.onloadstart = me.onLoadStart;
        reader.onprogress = me.onProgress;
        reader.onabort = me.onAbort;
        reader.onerror = me.onerror;
        reader.onload = me.onLoad;
        reader.onloadend = me.onLoadEnd;
        //读取第一块
        me.readBlob(file, 0);
    },
    onLoadStart: function() {
        var me = h;
    },
    onProgress: function(e) {
        var me = h;
         
        me.loaded += e.loaded;
        //更新进度条
        me.progress.value = (me.loaded / me.total) * 100;
    },
    onAbort: function() {
        var me = h;
    },
    onError: function() {
        var me = h;
         
    },
    onLoad: function() {
        var me = h;
 
        if(me.loaded < me.total) {
            me.readBlob(me.loaded);
        } else {
            me.loaded = me.total;
        }
    },
    onLoadEnd: function() {
        var me = h;
         
    },
    readBlob: function(start) {
        var me = h;
         
        var blob,
            file = me.file;
         
        me.times += 1;
         
        if(file.webkitSlice) {
            blob = file.webkitSlice(start, start + me.step + 1);
        } else if(file.mozSlice) {
            blob = file.mozSlice(start, start + me.step + 1);
        }
         
        me.reader.readAsText(blob);
    },
    abortHandler: function() {
        var me = h;
         
        if(me.reader) {
            me.reader.abort();
        }
    }
};
 
h.init();



本文章已经生成可运行项目
<think> 我们正在回答用户关于JavaScript中FileReader的readAsText方法的问题。需要参考提供的引用内容,并结合相关知识给出清晰的结构化回答。 引用内容总结: 引用1:FileReader是浏览器提供的API,用于异步读取文件,支持多种读取方法,包括readAsText。它是异步的,通过事件监听获取结果。 引用2:一个简单的示例,使用readAsText读取文本文件。 引用3:一个详细的示例,展示了FileReader的各种事件(onloadstart, onload, onloadend, onprogress, onabort, onerror)和状态(readyState)。 引用4:注意readAsText读取的是文本数据,如果需要二进制格式,应使用readAsArrayBuffer或readAsDataURL。 引用5:另一个示例,展示了如何通过input元素获取文件,并使用readAsDataURL(注意不是readAsText,但结构类似)读取为base64。 用户需求:使用指南、示例代码、注意事项等。 回答结构: 1. 简介:readAsText方法的作用和适用场景。 2. 使用指南:包括创建FileReader对象、调用readAsText方法、事件处理。 3. 示例代码:展示一个完整的读取文本文件的例子。 4. 注意事项:包括异步性、事件顺序、错误处理、文件大小限制、编码问题等。 5. 扩展:其他读取方法的简要对比。 注意:所有行内代码(如方法名、属性名)使用$...$格式,独立代码块使用```...```,并按照要求添加引用标识。 </think> ### JavaScript FileReader.readAsText() 使用指南及示例 `FileReader.readAsText()` 是浏览器提供的异步文件读取方法,专门用于**将文件内容解析为文本字符串**(如.txt/.csv/.json等),适用于前端文本文件处理场景。 #### 一、核心使用指南 1. **方法签名** ```javascript readAsText(blob[, encoding]) ``` - `blob`:必选,Blob 或 File 对象(通常来自 `<input type="file">`) - `encoding`:可选,文本编码格式(默认 UTF-8),支持 `ISO-8859-1` 等[^1] 2. **操作流程** ```mermaid graph LR A[创建FileReader对象] --> B[注册onload事件] B --> C[调用readAsTextfile] C --> D[通过result获取文本] ``` 3. **关键事件** | 事件 | 触发时机 | 用途 | |---|---|---| | `onload` | 读取成功完成 | 通过 `reader.result` 获取文本 | | `onerror` | 读取失败 | 通过 `reader.error` 获取错误信息 | | `onprogress` | 读取过程中 | 通过 `e.loaded/e.total` 跟踪进度 | | `onabort` | 读取被中断 | 处理取消操作[^3] | #### 二、完整示例代码 ```html <input type="file" accept=".txt,.csv,.json" onchange="readTextFile(this)"> <script> function readTextFile(input) { if (!input.files[0]) return; const reader = new FileReader(); const file = input.files[0]; // 设置文本编码(可选) reader.readAsText(file, "UTF-8"); // 成功读取 reader.onload = () => { console.log("文件内容:", reader.result); document.getElementById("output").innerText = reader.result; }; // 读取失败 reader.onerror = () => { console.error("读取错误:", reader.error); }; // 读取进度 reader.onprogress = (e) => { const percent = Math.round((e.loaded / e.total) * 100); console.log(`读取进度: ${percent}%`); }; } </script> <div id="output"></div> ``` #### 三、注意事项 1. **异步特性** 文件读取不会阻塞主线程,结果需通过事件监听获取。`reader.readyState` 标识状态: - `0`:未加载 - `1`:加载中 - `2`:加载完成[^3] 2. **文件类型限制** - 适合:文本文件(TXT/CSV/XML/JSON 等) - 不适合:二进制文件(图片/视频/EXE),此类文件应使用 `readAsArrayBuffer()` 或 `readAsDataURL()`[^4] 3. **安全限制** - 只能读取用户**主动选择**的文件(通过 `<input type="file">`) - 无法直接读取文件系统路径 4. **大文件处理** 超过 50MB 的文件需分片读取或使用 `onprogress` 进度提示[^5],避免内存溢出: ```javascript // 分片读取示例 const chunkSize = 1024 * 1024; // 1MB let offset = 0; function readChunk() { const slice = file.slice(offset, offset + chunkSize); reader.readAsText(slice); } ``` #### 四、与其他读取方法对比 | 方法 | 输出格式 | 适用场景 | |---|---|---| | `readAsText()` | 字符串 | 文本解析/日志分析 | | `readAsDataURL()` | Base64 字符串 | 图片预览 | | `readAsArrayBuffer()` | ArrayBuffer | 二进制处理 | | `readAsBinaryString()` | 二进制字符串 | 传统格式兼容[^1] | #### 五、常见问题解决方案 1. **中文乱码** 指定 GBK 编码(需第三方库如 `iconv-lite` 配合): ```javascript import iconv from 'iconv-lite'; reader.onload = () => { const gbkBuffer = iconv.decode(reader.result, 'GBK'); }; ``` 2. **读取中断** 主动终止读取操作: ```javascript document.getElementById("cancelBtn").onclick = () => { reader.abort(); // 触发 onabort 事件 }; ``` 3. **多文件处理** 遍历文件列表并创建多个 FileReader 实例: ```javascript Array.from(input.files).forEach(file => { const reader = new FileReader(); reader.readAsText(file); }); ``` **典型应用场景**:日志分析、CSV 数据导入、配置文件解析、客户端文本搜索等。 --- ###
评论 7
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值