前端可通过Blob和a[download]实现文件下载,如文本、JSON、CSV等;利用URL.createObjectURL创建临时链接,动态触发下载,适用于导出数据场景。
在前端开发中,JavaScript 本身不能直接操作用户的文件系统,出于安全考虑,浏览器限制了对本地文件的读写权限。但可以通过一些方法实现“下载文件”的功能,比如将文本、JSON、CSV 等内容生成文件并触发浏览器下载。
这是最常用的方式,适用于导出文本类数据(如 TXT、CSV、JSON)或二进制数据(如图片、PDF)。
原理: 将数据包装成 Blob 对象,创建一个临时的 URL,然后通过动态创建的 标签触发下载。
示例:下载一段文本为 .txt 文件
function downloadText(content, filename) {
const blob = new Blob([content], { type: 'text/plain' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = filename;
a.click();
URL.revokeObjectURL(url); // 释放内存
}
// 调用
downloadText('Hello, 这是要保存的内容', 'note.txt');
示例:下载 JSON 数据
function downloadJSON(data, filename) {
const content = JSON.stringify(data, null, 2);
const blob = new Blob([content], { type: 'application/json' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = filename;
a.click();
URL.revokeObjectURL(url);
}
// 调用
downloadJSON({ name: '张三', age: 30 }, 'user.json');
将数组数据转换为 CSV 格式并下载。
function downloadCSV(rows, filename) {
const csvContent = rows.map(row => row.join(',')).join('\n');
const blob = new Blob(['\uFEFF' + csvContent], { type: 'text/csv;charset=utf-8;' }); // 加 BOM 避免中文乱码
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = filename;
a.click();
URL.revokeObjectURL(url);
}
// 调用示例
const data = [
['姓名', '年龄'],
['李四', '25'],
['王五', '28']
];
downloadCSV(data, 'users.csv');
如果只是想让用户下载服务器上的某个文件,可以直接使用带有 download 属性的链接。
下载PDF
注意:跨域资源可能无法触发自动下载,需服务端设置 Content-Disposition 头。
及以下,IE10+ 需使用 msSaveBlob
基本上就这些。JavaScript 的“下载”本质是生成数据并触发浏览器行为,而不是真正的文件系统操作。只要理解 Blob 和 a[download] 的配合使用,大多数导出需求都能满足。