在前端开发中，我们经常需要处理文件下载。而在HTTP协议中，可以通过设置Content-Disposition响应头来指示客户端如何处理响应的内容。npm上有一个名为content-disposition的包可以帮助我们方便地设置Content-Disposition响应头。本文将向大家介绍如何使用该包以及常见的用法。
安装
安装content-disposition非常简单，只需在命令行中输入：
npm install content-disposition
用法
基本用法
最基本的用法是使用contentDisposition函数来生成Content-Disposition头信息。例如，以下代码可以设置让浏览器弹出"save as"对话框来保存文件：
const contentDisposition = require('content-disposition')
res.setHeader('Content-Type', 'application/pdf')
res.setHeader('Content-Disposition', contentDisposition('myFile.pdf'))其中，contentDisposition函数接受一个字符串参数，表示要下载的文件名。注意，如果文件名包含非ASCII字符或空格等特殊字符，必须使用encodeURIComponent函数进行编码。
指定文件名编码格式
如果文件名包含非ASCII字符，我们需要将其编码成指定的字符集，通常为UTF-8。这时可以使用contentDisposition.parse函数来指定编码格式。例如，以下代码设置要下载的文件名为"中文文件.txt"：
const contentDisposition = require('content-disposition')
const filename = '中文文件.txt'
res.setHeader('Content-Type', 'text/plain; charset=utf-8')
res.setHeader('Content-Disposition', contentDisposition(filename, { type: 'inline', encode: true }))其中，encode参数设为true表示需要对文件名进行编码。
指定下载方式
除了"save as"对话框外，我们还可以设置让浏览器直接在页面中打开文件（例如图片或PDF）而不是下载。这时可以使用type参数指定下载方式。例如，以下代码将PDF文件以内联方式显示：
const contentDisposition = require('content-disposition')
res.setHeader('Content-Type', 'application/pdf')
res.setHeader('Content-Disposition', contentDisposition('myFile.pdf', { type: 'inline' }))其他选项
contentDisposition函数还支持其他选项，例如指定文件大小和创建日期等。有关更多详细信息，请参阅文档。
总结
本文介绍了如何使用content-disposition包来设置Content-Disposition响应头，包括设置文件名、编码格式和下载方式等。希望通过本文的学习，读者们能够更好地处理文件下载相关的工作，在实际开发中提高效率。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/49141