Express.js req.range() 函数

在Express.js中，req.range()函数用于解析HTTP Range头以支持范围请求（Range Request）。

范围请求是指客户端请求服务器从资源中返回指定范围内的数据，而非全部数据。这可以用于大文件的分块传输，减少带宽占用和提高传输效率。

如何使用

首先需要在Express应用程序中启用范围请求支持，这可以通过使用range-parser中间件来实现：

const range = require('range-parser')
const app = express()

app.use((req, res, next) => {
  req.range = range(req.headers['range'], fileSize)
  next()
})

在上面的代码中，我们使用range-parser中间件将req.headers['range']解析为一个范围数组。其中，fileSize是整个文件的大小（以字节为单位）。

要返回请求范围内的数据，可以使用以下代码：

res.status(206)
   .set('Content-Range', 'bytes ' + range.start + '-' + range.end + '/' + fileSize)
   .send(fileBuffer.slice(range.start, range.end + 1))

在上面的代码中，我们设置了HTTP状态码为“206”（部分内容），并设置了Content-Range标头，该标头指定了服务器返回数据的范围。最后，我们将请求范围内的数据发送回客户端。

要返回完整文件，可以使用以下代码：

res.status(200)
   .set('Content-Length', fileSize)
   .send(fileBuffer)

注意事项

• req.range()函数仅支持单个范围请求。如果客户端发送了多个范围请求，将会抛出错误。
• 如果请求的范围无效，req.range() 函数将返回一个空数组。
• 如果请求的范围超出整个文件的大小，req.range() 函数将返回请求的整个文件范围。
• range-parser 中间件默认限制请求范围的最大大小为1MB。如果你需要处理更大的请求范围，请使用range-parser的自定义选项来修改。

结论

req.range() 函数是Express.js中一个非常有用的函数，它允许服务器支持范围请求，从而提高传输效率，减少带宽占用，尤其适用于大文件的分块传输。要使用 req.range() 函数，你需要使用 range-parser 中间件来解析HTTP Range头，然后使用范围数组来处理请求的范围。