欢迎光临
我们一直在努力

SEAJS COMBO 插件 使用说明

减少 HTTP 请求数是性能优化中非常重要的一条准则。使用 combo 插件,配合服务器的 nginx-http-concat服务(安装指南),可自动对同一批次的多个模块进行合并下载。

使用场景

seajs.use([‘a’, ‘b’], …);

require.async([‘a’, ‘b’], …);

define(‘id’, [‘a’, ‘b’], …);
上面这些场景中的 a.js 和 b.js 可以合并成 http://example.com/path/to/??a.js,b.js 一起下载。

引入方式

使用很简单,只要加载 sea.js 时,同时加载 seajs-combo.js 即可:

<script src=”http://test.com/??path/to/sea.js,path/to/seajs-combo.js”></script>
或者在 sea.js 之后用 script 引入:

<script src=”path/to/sea.js”></script>
<script src=”path/to/seajs-combo.js”></script>
推荐用 ??path/to/sea.js,path/to/seajs-combo.js 的方式激活,这可以少一个请求。

提示:其他需要线上使用的插件,都推荐通过 ??path/to/sea.js,path/to/seajs-xxx.js 的方式使用。

配置项

comboSyntax Array

加载 combo 插件后,可以通过 comboSyntax 配置更改 combo 规则:

seajs.config({
comboSyntax: [‘?’, ‘&’]
})
上面的配置,会将 combo 规则改成类 YUI Loader 的形式:http://example.com/path/to/?a.js&b.js

comboExcludes RegExp | Function

可以通过 comboExcludes 排除掉特定文件:

seajs.config({
comboExcludes: /jquery\.js/ // 从 combo 中排除掉 jquery.js 
})
comboExcludes 可以是正则,也可以是一个函数:

seajs.config({
comboExcludes: function(uri) {
// 某些特定目录下的文件不合并
if (uri.indexOf('/some/path/') > 0) {
return true
}
}
})

 

在激活 combo 插件后,如果需要临时禁用 combo,可以

seajs.config({
comboExcludes: /.*/
})
上面的配置把所有文件都排除掉了,因此 combo 也就不生效了。

提示:combo 插件已经做了去重等处理,已经下载或正在下载的,不会重复下载。

comboMaxLength Number

combo 后的 URL 地址太长时,IE 以及有些服务器的配置会不支持。目前最佳经验值是不超过 2000 个字符。

seajs.config({
// 将 combo URL 的最大长度修改为 1000 个字符
comboMaxLength: 1000
})
测试页面

http://seajs.github.io/seajs/tests/specs/extensible/test.html?seajs-combo

合并请求并添加max-age

var re_cdn_request_uri = /\w+\.r\d+\.(?:js|css)/;// 匹配 xxx.r201501201234.js

seajs.config({
charset: 'utf-8',
comboSyntax: ['/c/=', ','] // for seajs-combo
});

seajs.on('fetch', function (req) {
var uri = req.requestUri || req.uri;
if (uri) {
if (re_cdn_request_uri.test(uri)) {
uri += (req.uri.indexOf('?') === -1 ? '?' : '&') + 'max_age=31104000';
}
req.requestUri = uri;
}
});

 

赞(0)
版权归原作者所有,如有侵权请告知。达维营-前端网 » SEAJS COMBO 插件 使用说明

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址