koa2-static2
项目介绍
- 基于 koa2、koa-static 中间件扩展带协商缓存的中间件
功能
- 遵循 HTTP 协议缓存机制
- 基于及集成 koa-static
- 支持协商缓存
- 可配置开启文件类型(默认禁止 HTML 文件缓存)
安装
- (c)npm install koa2-static2 -D
使用
基础使用
默认开启协商缓存并禁止 HTML 文件缓存,在静态资源中每次都会发送请求检查服务端是否有更新
const koa2Static2 = ; const Koa = ; const path = ; const staticPath = path; const app = ; koa2Static2; app; console;
强制缓存优先(推荐)
浏览器先检测是否已经开启强制缓存,在强制缓存时间过期之后再发送请求检查服务端是否有更新
koa2Static2;
过滤指定资源
通过配置项指定 excludeExtensionCache
指定需要被忽略的文件类型,由于直接覆盖默认配置如果禁止 html
类型扔需手动传入
koa2Static2;
koa-static
源用法
koa2Static2
本身是一个函数,基于 koa-static
,所以 api 保持一致
app;
API
-
function
- koa2Static2
- param 和 koa-static 一致
- return
- function <Function>
- koa2Static2
-
methods
- install
- param
- koaApp <Object> koa 实例
- staticPath <String> 静态资源目录、同 koa-static 第一个参数
- options <Object> 同 koa-static 第二个参数
- excludeExtensionCache 继承参数、参考上面示例
- maxage
- setHeaders
- ...
- return
- void
- param
- install
其他
- 若使用
setHeaders
中设置Cache-Control
、Pragma
、Last-Modified
、Etag
将无效