讲师中心 微信公众号
AI工具推荐 视频效率加速

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

夏枫姑娘_5678

夏枫姑娘_5678

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

|

141人浏览过

|

来源于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 实例。

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

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

正确写法示例:

html-to-pptx-converter
html-to-pptx-converter

使用 PptxGenJS 和 Python 解析,将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint(.pptx)演示文稿。

下载

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

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-Disposition 的 filename 由 append 第三个参数注入)
  • 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 的逻辑都会静默失效。

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

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

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

2746

2023.08.11

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

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

5399

2023.11.06

Chrome开启无痕模式
Chrome开启无痕模式

本专题整合了Chrome无痕模式开启相关内容,阅读专题下面的文章了解更多详细教程。

3847

2026.03.24

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

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

2238

2023.09.20

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

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

1758

2023.08.03

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

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

2744

2023.09.04

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

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

6104

2023.10.24

字符串介绍
字符串介绍

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

5749

2023.11.24

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 224人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn