在对象字面量中可直接声明 async 方法，es2017+ 支持简写语法，自动返回 promise，天然支持 try/catch，需统一错误语义、避免 this 丢失，并可通过工厂函数注入依赖。
在对象字面量中直接声明 async 方法是完全可行的，且能自然体现“高内聚契约”——即方法语义、执行时机、错误边界与返回形态在一处清晰定义，无需额外包装或工厂函数。
直接使用 async 方法简写语法
ES2017+ 支持在对象字面量中用简写形式声明异步方法，无需箭头函数或显式 return Promise：
- 方法前加 async 关键字，内部用 await 处理异步逻辑
- 该方法自动返回 Promise，调用者可 await 或 .then() 消费
- 天然支持 try/catch 错误捕获，异常会以 rejected Promise 形式向外抛出
示例：
const apiClient = {
async fetchUser(id) {
try {
const res = await fetch(`/api/users/${id}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
return await res.json();
} catch (err) {
throw new Error(`Failed to fetch user ${id}: ${err.message}`);
}
},
async updateUser(id, data) {
const res = await fetch(`/api/users/${id}`, {
method: 'PUT',
body: JSON.stringify(data),
headers: { 'Content-Type': 'application/json' }
});
return res.ok ? await res.json() : Promise.reject(new Error('Update failed'));
}
};
保持契约一致性：统一返回形态与错误语义
高内聚契约的核心不是“能否异步”，而是“如何被一致消费”。建议统一约定：
- 所有 async 方法都返回 fulfilled Promise（成功时含业务数据）或 rejected Promise（失败时含标准化 Error 实例）
- 避免混合返回：不混用
return value和return Promise.resolve(value)，让 async 自动封装即可 - 错误信息应包含上下文（如操作名、关键参数），便于调试和监控
需要时注入依赖，而非硬编码
若方法需外部服务（如 axios 实例、认证 token），可通过闭包或工厂函数注入，维持字面量的纯净性与可测试性：
const createApiClient = (httpClient, baseUrl) => ({async fetchPost(id) {
const res = await httpClient.get(`${baseUrl}/posts/${id}`);
return res.data;
}
});
// 使用
const client = createApiClient(axios, 'https://api.example.com');
慎用 this 绑定问题
对象字面量中的 async 方法默认绑定到当前对象，但若解构后单独调用（如 const { fetchUser } = apiClient; fetchUser(1)），this 会丢失。解决方案：
- 调用时始终通过对象上下文：
apiClient.fetchUser(1) - 或改用箭头函数包裹（但会失去方法名、不可枚举、不推荐用于公共契约）
- 更稳妥的做法：在构造器/工厂中绑定，或接受显式 context 参数
