的异步编程实践与优化)
1. 理解$q.when()的核心定位
在AngularJS的异步编程体系中，$q.when()是一个常被忽视但极具实用价值的工具函数。它的核心作用是"规范化处理值或承诺"，简单说就是无论你传入的是普通值还是Promise对象，它都能统一返回一个Promise。这种特性在混合处理同步和异步逻辑时特别有用。
举个例子，假设我们有个函数可能返回字符串也可能返回Promise：
function fetchData() { return Math.random() > 0.5 ? $http.get('/api/data') : 'static data'; }使用$q.when()可以确保后续处理的一致性：
$q.when(fetchData()).then(function(result) { console.log(result); // 无论数据来源都能正确处理 });2. $q.when()与$q.resolve()的异同
很多开发者会混淆这两个方法，其实在AngularJS 1.x中它们是完全等价的别名关系。源码中可以清晰看到：
function when(value, callback, errback, progressBack) { return resolve(value, callback, errback, progressBack); }但在实际项目中建议保持一致性：
- 团队统一使用$q.when()
- 或统一使用$q.resolve() 避免混用造成理解成本
3. 典型应用场景深度解析
3.1 接口兼容处理
当编写需要同时支持同步和异步输入的函数时：
function process(input) { return $q.when(input).then(function(value) { // 统一处理逻辑 return value.toUpperCase(); }); } // 同步调用 process('hello').then(console.log); // 输出"HELLO" // 异步调用 process($q.resolve('world')).then(console.log); // 输出"WORLD"3.2 延迟加载控制
结合路由控制实现智能加载：
$routeProvider.when('/detail', { resolve: { preload: function() { return $q.when( window.preloadedData || $http.get('/api/detail') ); } } });3.3 单元测试模拟
在测试中简化异步场景模拟：
// 被测函数 function asyncAdd(a, b) { return $q.when(a + b); } // 测试用例 it('should add numbers', function(done) { asyncAdd(2, 3).then(function(result) { expect(result).toEqual(5); done(); }); });4. 高级用法与性能优化
4.1 链式操作优化
避免不必要的Promise封装：
// 不推荐写法 function getData() { return $q.when($q.when($q.when('data'))); } // 优化写法 function getData() { return $q.when('data'); }4.2 批量处理模式
结合$q.all实现批量转换：
function normalizeAll(items) { return $q.all(items.map(item => $q.when(item))); }4.3 内存管理
注意避免内存泄漏：
// 潜在泄漏 var hugeData = /* 大数据 */; $q.when(hugeData).then(function() { // 处理完成后手动释放 hugeData = null; });5. 常见问题排查指南
5.1 循环引用问题
当处理包含循环引用的对象时：
var obj = {}; obj.self = obj; $q.when(obj); // 会导致序列化异常解决方案：
$q.when(JSON.parse(JSON.stringify(obj)));5.2 AngularJS版本差异
注意不同版本的细微差别：
- 1.2.x: $q.when()不支持进度通知
- 1.3+: 支持progress回调
// 1.3+ 支持写法 $q.when(promise, success, error, progress);5.3 与第三方库的整合
与jQuery等库配合使用时：
// 将jQuery Deferred转为$q promise $q.when($.ajax('/api')).then(...);6. 最佳实践总结
- 防御性编程：对所有可能返回Promise或值的函数使用$q.when()包装
- 性能优先：避免对已知的非Promise值进行不必要的包装
- 代码可读性：在团队内建立统一的用法规范
- 错误处理：始终添加catch处理未捕获的异常
// 完整示例 function robustFetch(url) { return $q.when( typeof url === 'string' ? $http.get(url) : url ).then(response => response.data) .catch(error => { console.error('Fetch failed:', error); return $q.reject(error); }); }在实际项目中，合理运用$q.when()可以显著提升异步代码的健壮性和可维护性。特别是在处理第三方库集成或遗留代码改造时，这个看似简单的方法往往能解决复杂的接口兼容问题。
