浏览器原生支持直接预览的文件类型包括PDF(application/pdf)、图片(如image/jpeg、image/png、image/gif、image/webp)、纯文本(text/plain)、SVG(image/svg+xml)、HTML(text/html)及部分音视频(video/mp4、audio/mpeg);需注意MIME类型匹配与浏览器兼容性。

哪些文件类型能直接在浏览器预览
不是所有文件都能用 或 安全预览。浏览器原生支持的主要是:PDF、图片(jpg/png/gif/webp)、文本(txt/csv)、SVG 和部分 HTML 文件。视频(mp4/webm)、音频(mp3/wav)可用 / 标签,但需注意 MIME 类型是否匹配。
常见失败场景:上传了 .docx 却试图用 —— 浏览器既不识别该 MIME 类型,也不会触发下载,通常静默失败或显示空白。
用 URL.createObjectURL() 生成临时预览地址
这是客户端预览的核心方法:把用户选中的 File 对象转成可被 、、 等直接引用的本地 URL。它不上传文件,也不访问服务器,纯前端完成。
实操要点:
- 必须在用户触发文件选择(如
的change事件)后调用,不能提前生成 - 每次调用会创建新 URL,旧 URL 不自动释放,需手动调用
URL.revokeObjectURL()避免内存泄漏 -
File对象本身是Blob子类,所以createObjectURL()接收file或blob均可
示例(图片预览):
const input = document.querySelector('input[type="file"]');
input.addEventListener('change', (e) => {
const file = e.target.files[0];
if (!file || !file.type.startsWith('image/')) return;
const url = URL.createObjectURL(file);
const img = document.querySelector('#preview');
img.src = url;
// 清理:下次选新图前先释放旧 URL
img.onload = () => URL.revokeObjectURL(url);
});
PDF 和文本文件怎么安全预览
PDF 是最常被问到的类型,但要注意: 直接加载 objectURL 在部分 Chrome 版本中会触发下载而非预览(尤其当响应头缺失 Content-Disposition: inline —— 但客户端无服务端响应头可设)。更稳的方式是用 或 ,并显式指定 type="application/pdf"。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件(幻灯片风格)。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本,并且希望生成演示用的 HTML 时触发。支持任意内容来源:iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区,并通过企微直接发送给用户。触发词示例:帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
文本类(.txt, .csv, .log)建议用 + FileReader 读取内容,避免 MIME 不匹配导致 iframe 白屏:
-
FileReader.readAsText(file)可指定编码(如'utf-8'),对中文文件很重要 - 不要依赖
file.type判断是否为文本 —— 用户可能改后缀,应结合内容检测(如读前几个字节)或白名单后缀校验 - 大文件(>10MB)用
FileReader可能卡顿,需加 loading 提示或分块读取(较复杂,一般项目里直接限制文件大小更实际)
移动端和 Safari 的兼容性坑
iOS Safari 对 objectURL 支持有限:它允许 和 使用,但 和 加载 PDF 会直接下载,而不是内嵌预览。Android Chrome 相对稳定,但旧版 WebView 可能不支持 createObjectURL。
应对策略:
- 对 PDF,优先尝试
;失败则降级为提供「下载」按钮,并提示“当前设备不支持在线预览” - 检查
URL.createObjectURL是否存在(Safari 15.4+ 才完全支持Blob参数,早期只支持MediaSource) - 不要用
data:URI 预览 PDF —— 它会因长度限制(约 2MB)截断,且 Base64 编码体积膨胀 33%
真正难处理的是跨域 iframe 场景下想预览远程 PDF —— 那已不属于“客户端预览”范畴,必须走服务端代理或 CORS 配置,这点容易混淆。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










