在前端开发中，经常需要在 HTTP 响应头部设置 Vary 字段。该字段用于指示缓存内容的变化因素，从而保证缓存的有效性。而 vary 是 Node.js 中常用的一个处理 Vary 字段的工具包。
本篇文章将介绍 vary 的使用方法，包括安装、基本使用和高级用法。
安装
首先，需要使用 npm 工具进行安装，执行如下命令：
npm install vary --save
这个命令会将 vary 包下载并添加到项目依赖中。
基本用法
在使用 vary 之前，先了解一下 Vary 字段的基本使用。简单来说，Vary 字段可以设置为：
*，表示接收所有请求头，每个请求的响应都是唯一的。- 某个请求头名称，比如
Accept-Encoding，表示该请求头的值决定了响应的唯一性。 - 多个请求头名称，用逗号分隔。
在 Node.js 中，可以使用 vary 模块来处理 Vary 字段。基本用法如下：
-- -------------------- ---- ------- ----- ---- - ---------------- ----- ---- - ---------------- ----------------------- ---- -- - -- ------ ---- -- --------- ------------------- -- ------- ----------------
在上述代码中，调用 vary 方法设置了响应头的 Vary 字段为 Accept-Encoding，因此只有该请求头的值不同时，缓存中的响应内容才会被替换。
高级用法
除了基本用法以外，vary 还提供了一些高级用法，可以更灵活地控制缓存和响应。
append
vary.append 方法可以追加一个或多个请求头名称到 Vary 字段中：
vary.append(res, 'Accept-Language, User-Agent');
remove
vary.remove 方法可以从 Vary 字段中移除一个或多个请求头名称：
vary.remove(res, 'Accept-Encoding');
parse
vary.parse 方法可以将 Vary 字段解析为请求头名称的数组：
vary.parse('Accept-Encoding, Accept-Language');
// => ['Accept-Encoding', 'Accept-Language']format
vary.format 方法可以将请求头名称数组格式化为 Vary 字段的字符串：
vary.format(['Accept-Encoding', 'Accept-Language']); // => 'Accept-Encoding, Accept-Language'
示例
下面是一个简单的示例，演示了如何使用 vary 来控制缓存内容：
-- -------------------- ---- -------
----- ---- - ----------------
----- ---- - ----------------
----------------------- ---- -- -
-- -- --------------- -----
----- -------- - -------------------------------
-- ------------- ---- --
--------- -------------------
-- -------------------
-- ----------------------- -
-------------- - ----
------ ----------
-
-- ----
--------------------------------- --------
----------------------------- --------------
-- ----------------------- -
----- ---- - ----------------
----- ------ - ------------------
-----------------
------------------ ---------
- ---- -
--------------- ---------
-
----------------以上代码定义了一个 HTTP 服务，当浏览器第一次请求时，服务器会根据请求头中的 Accept-Encoding 字段设置响应头的 Vary 字段。然后，根据请求头中的 Accept-Encoding 字段来决定是否采用 Gzip 压缩响应内容。如果采用了 Gzip 压缩，则需要设置 Content-Encoding 响应头，表示采用 Gzip 压缩。如果缓存中已经有了响应缓存，则直接返回缓存内容，不需要再次压缩。
总结
本文介绍了 npm 包 vary 的基本用法和高级用法，并通过一个示例代码展示了如何使用 vary 控制 HTTP 响应的缓存内容。在实际开发中，熟练掌握 vary 的使用可以使得缓存更加高效，提高网站性能和用户体验。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/40498