0

0

HTML5Blob转File对象_HTML5给二进制数据添加文件名MIME类型教程【操作】

蓮花仙者

蓮花仙者

发布时间:2026-02-24 21:51:25

|

101人浏览过

|

来源于php中文网

原创

new file([blob], filename, {type: mimetype}) 是唯一可靠方式,可生成带 name 和 type 的真实 file 实例,兼容现代浏览器,ios safari 16.4+ 才支持,旧版需降级用 formdata.append('file', blob, filename)。

html5blob转file对象_html5给二进制数据添加文件名mime类型教程【操作】

如何用 Blob 构造出带名字和 MIME 的 File 对象

直接说结论:new File([blob], filename, {type: mimeType}) 是唯一可靠方式。不是用 blob.name 赋值,也不是靠 URL 或 slice() 伪装——那些都不生成真正的 File 实例。

浏览器里 FileBlob 的子类,但多了 namelastModified 两个关键属性。表单上传、input[type="file"] 模拟、拖拽 API 入参等场景,后端或框架常依赖 File.name 做文件路由或校验,光有 Blob 会失败。

  • filename 必须是字符串,不能含路径(如 "./uploads/photo.jpg" 会被忽略,只取 "photo.jpg"
  • type 参数不强制,但建议显式传入;若为空字符串或无效 MIME,file.type 会 fallback 为 "",部分上传库(如 axios + FormData)可能丢弃该字段
  • 传入的 blob 可以是原始 Blob,也可以是 ArrayBufferUint8ArrayFile 构造函数内部会自动转成 Blob

File 构造失败的常见报错和原因

典型错误是 TypeError: Failed to construct 'File': parameter 1 is not of type 'Blob'。这不是因为你没传 Blob,而是传了“看起来像 Blob”但实际不是的对象。

  • fetch().then(r => r.blob()) 得到的是真 Blob,可用
  • new Blob([arrayBuffer]) 创建的是真 Blob,可用
  • response.arrayBuffer() 返回的是 Promise<arraybuffer></arraybuffer>,直接塞进 new File([res.arrayBuffer()], ...) 就会报错——你传的是 Promise,不是 ArrayBuffer
  • URL.createObjectURL(blob) 生成的字符串是地址,不是 Blob,也不能当构造参数

正确写法示例:

清程爱画
清程爱画

AI图像与视频生成平台,拥有超丰富的工作流社区和多种图像生成模式。

下载

立即学习前端免费学习笔记(深入)”;

fetch('/api/image')
  .then(r => r.arrayBuffer())
  .then(buf => {
    const blob = new Blob([buf], {type: 'image/png'});
    const file = new File([blob], 'avatar.png', {type: 'image/png'});
    // ✅ file instanceof File === true
    // ✅ file.name === 'avatar.png'
    // ✅ file.type === 'image/png'
  });

兼容性与移动端要注意的细节

File 构造函数在 Chrome 76+、Firefox 69+、Safari 16.4+ 支持,iOS Safari 16.4 是关键分水岭——低于此版本(比如 iOS 15.x)会直接抛 ReferenceError: File is not defined

  • 不要试图 polyfill File 构造函数:它的原型链和内部 slot(如 [[FileSystem]])无法模拟
  • 降级方案只能是绕过 File,改用 FormData.append('file', blob, filename) 直接传 Blob,前提是后端接受无名二进制体(此时 Content-Dispositionfilenameappend 第三个参数注入)
  • Android WebView 旧版本(Chrome typeof File !== 'undefined' && 'name' in File.prototype

为什么不用 blob.name = 'xxx'

因为 Blob.name 是只读属性,赋值无效,且不会影响任何行为。这是最常被误信的“快捷方式”。

  • const b = new Blob(['test']); b.name = 'hello.txt'; console.log(b.name); // undefined
  • 即使你用 Object.defineProperty 强行定义,也改不了它在 FormData 中的表现:浏览器仍按匿名 Blob 处理,Content-Disposition 不带 filename
  • 某些调试器(如 Chrome DevTools)显示 name 字段是假象——它只是把 toString() 结果格式化成类似 Blob {size: 4, type: "", name: "unknown"},不代表真实可读属性

真要加名字,只有 new File 这一条路。别省那几行代码,否则后续所有基于 file.name 的逻辑都会静默失效。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

983

2023.08.11

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

802

2023.11.06

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

552

2023.09.20

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

638

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

217

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1558

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

642

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

1027

2024.03.22

Golang 生态工具与框架:扩展开发能力
Golang 生态工具与框架:扩展开发能力

《Golang 生态工具与框架》系统梳理 Go 语言在实际工程中的主流工具链与框架选型思路,涵盖 Web 框架、RPC 通信、依赖管理、测试工具、代码生成与项目结构设计等内容。通过真实项目场景解析不同工具的适用边界与组合方式,帮助开发者构建高效、可维护的 Go 工程体系,并提升团队协作与交付效率。

1

2026.02.24

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.4万人学习

AngularJS教程
AngularJS教程

共24课时 | 3.8万人学习

CSS教程
CSS教程

共754课时 | 35.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号