在 ExtJS 项目里,很多业务接口都要求携带相同的附加字段,例如 token 或渠道标识。与其在每个请求里单独写,不如在系统启动时统一给 Ext.Ajax 设置额外参数,这样后续所有请求都会自动带上这些内容。

方式一:使用 extraParams 配置默认参数
Ext.Ajax 本身支持 extraParams 属性,给它赋值后,所有通过 Ext.Ajax.request 发出的请求都会合并这些参数。
// 全局设置额外参数
Ext.Ajax.extraParams = {
token: 'abc123',
lang: 'zh_CN'
};
// 后续请求会自动带上上述参数
Ext.Ajax.request({
url: 'https://ipipp.com/api/user',
method: 'POST',
params: {
id: 1
},
success: function(response) {
console.log(response.responseText);
}
});
方式二:监听 beforerequest 事件动态添加
如果参数需要动态获取,比如从本地存储读取最新令牌,可以监听 Ext.Ajax 的 beforerequest 事件,在请求发出前修改 options 对象。
Ext.Ajax.on('beforerequest', function(conn, options) {
options.params = options.params || {};
// 动态附加参数
options.params.token = localStorage.getItem('token');
options.params.timestamp = Date.now();
});
方式三:设置默认请求头
对于放在请求头更合适的参数,可以通过 Ext.Ajax.setDefaultHeaders 统一设置。
Ext.Ajax.setDefaultHeaders({
'X-App-Id': 'my_app',
'X-Client': 'web'
});
注意事项
- extraParams 是浅合并,若某次请求自己传了同名参数会覆盖全局值。
- beforerequest 中修改 options 不会影响已经序列化的 url 参数,需注意执行顺序。
- 使用 setDefaultHeaders 时,自定义头名尽量避免与浏览器禁止的头部冲突。
小结
全局设置 Ext.Ajax 请求的额外参数,核心就是利用 ExtJS 提供的 extraParams、事件机制和默认头配置。根据参数是否动态变化选择合适方案,可以大幅降低重复代码并提升维护性。