前言
在前端开发中，我们经常需要处理文件上传和下载的功能。其中一个重要的问题是如何支持分段下载（断点续传）。这就需要服务器端能够解析请求头中的 Range 字段，返回对应的数据块。
为了方便地解析 Range 请求头，我们可以使用 npm 包 range-parser。本文将详细介绍 range-parser 的使用方法，并提供示例代码和指导意义。
安装和引入
我们可以通过 npm 安装 range-parser：
--- ------- ------------ ------
然后，在 Node.js 中引入 range-parser：
----- ----------- - ------------------------
基础用法
range-parser 的基础用法非常简单。我们只需要调用它的 parse 函数，并传入请求头中的 Range 字段和文件大小即可：
----- ----------- - ------------------ ----- -------- - --------------------------- ----- ----- - --------------------- -------------
上述代码中的 rangeHeader 是请求头中的 Range 字段，fileSize 是文件的大小。range 就是解析出来的 Range 对象，包含 start 和 end 两个属性，表示请求的范围。
如果请求头中没有 Range 字段，range-parser 会返回 null。因此，我们需要判断 range 是否为空，并根据情况返回整个文件或者返回请求的数据块：
-- ------ --- ----- -
-- ---- ----- ----------
------ -----------------------------------
- ---- -
-- --- ----- -------------
----- - ------ --- - - ------
----- --------- - --- - ----- - --
----- ---------- - ----------------------------- - ------ --- ---
------------------------
---------------- ------ -----------------------------
---------------- --------
----------------- ----------
--------------------
-上述代码中，如果 range 不为空，则返回 HTTP 状态码 206（表示部分内容被发送），并设置相应的响应头。其中，'Content-Range' 表示返回的数据块在整个文件中的起止位置，'Accept-Ranges' 表示服务器支持分段下载，'Content-Length' 表示返回的数据块的长度。
最后，我们将数据块写入响应流中，返回给客户端即可。
深度和学习
除了基础用法外，range-parser 还提供了一些高级功能，让我们能够更加灵活地处理 Range 请求。
设置最大范围
通过设置 maxRange 参数，我们可以限制请求的范围不能超过指定大小：
----- ----- - --------------------- ------------ - --------- ------- ---
上述代码中，maxRange 的单位为字节。如果请求的范围超过了 1000000 字节，则 range-parser 会返回 null。
处理多个 Range 请求
有时候，我们需要同时处理多个 Range 请求。这种情况下，range-parser 会返回一个数组，包含每个请求对应的 Range 对象：
----- ----------- - ------------------ ----- -------- - --------------------------- ----- ------ - --------------------- ------------ - -------- ---- ---
上述代码中，combine 参数表示是否将多个请求合并为一个范围。如果不设置该参数，则默认只处理第一个请求。
自定义解析规则
如果你需要更加精细地控制 Range 请求的解析过程，可以通过自定义解析规则实现。例如，下面的代码将所有请求都解析为从文件末尾开始的范围：
----- ----------- - ------------------
----- -------- - ---------------------------
----- ----- - --------------------- ------------ -
------ ----- -- -
----- ----- -
----------------------------------------------------------- ----------
---------------------------------------------------------------------------------------