在前端开发中，经常需要向服务器上传文件。Multipart/form-data 是一种常用的上传文件的传输协议。然而，这种协议会产生多个请求，上传大文件时会有性能问题。tv-multipart 是一款基于流的 multipart/form-data 数据解析器，能够完美地解析复杂的请求，也能降低上传大型文件的负担。
安装
在使用 tv-multipart 之前，我们需要先将它安装到我们的项目中。通过 npm 可以快速地安装 tv-multipart。
npm install tv-multipart --save
用法
tv-multipart 可以将数据流 转换成 multipart/form-data 格式。它支持多种数据格式，包括文本、文件、媒体等等。以下是一个简单的例子，用于解析 POST 请求中的 multipart/form-data 数据。
-- -------------------- ---- -------
----- ---- - ----------------
----- --------- - ------------------------
----------------------- ---- -- -
------------- -- ------- -
-------------- ---- ----- ------- ------ -- -
------- -
-----------------
-------------- - ----
----------
-------
-
--------------------
-------------------
-------------- - ----
------------------------ ------- ----- ----
---
-
----------------上述代码通过 http 模块创建了一个简单的 Web 服务器，用于处理 POST 请求。当请求到达时，将执行 multipart() 方法来解析请求正文。字段 fields 存储了表单域的名称和值，其中值可以为 Buffer 或 String。字段 files 存储了上传的文件，其中值为一个对象，对象的 key 为表单域的名称，对象的值为文件的信息，如文件名、类型和大小等。
API
tv-multipart 提供了丰富的 API 来支持不同的条件。通过以下属性，可以轻松地控制 tv-multipart 的解析行为。
boundary
tv-multipart 默认使用“---------------------------7d33a816d302b6” 作为分界符。你可以通过设置 boundary 属性来自定义分界符。
var form = multipart.form({
autoFields: true,
boundary: 'aabbcc'
});autoFields
autoFields 是一个 bool 类型属性，代表是否创建普通表单域。如果它被设置为 false，则只解析文件数据。它默认为 true，包括表单域和文件域。
var form = multipart.form({
autoFields: false
});进阶
tv-multipart 还提供了一系列高级选项来定制数据解析器的行为。了解这些选项可以提高 tv-multipart 的效率和安全性。
maxDataSize
maxDataSize 表示一次解析数据时最多读取的字节数。如果数据流大小超过 maxDataSize，则 tv-multipart 将抛出错误并停止解析。
var form = multipart.form({
maxDataSize: 10000
});maxFileSize
maxFileSize 表示一次上传的最大文件大小（字节为单位）。如果上传的文件大小超过 maxFileSize，则 tv-multipart 将抛出错误并停止解析。
var form = multipart.form({
maxFileSize: 100000000
});generateFileName
generateFileName 是一个回调函数，用于生成上传文件的名称。如果回调函数未设置，则 tv-multipart 使用原始的文件名。
var form = multipart.form({
generateFileName: (file) => {
return 'file-' + Date.now() + '-' + file.name;
}
});总结
tv-multipart 是一个非常强大的数据解析器，可以让我们快速地解析 multipart/form-data 数据。通过阅读这篇文章，你应该已经掌握了 tv-multipart 的基本用法和高级选项。在以后的项目中，你可以使用 tv-multipart 来快速完成数据解析，提高前端开发的效率。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60057c2c81e8991b448ebbab