在联合类型中使用 async/await 的核心做法是:确保联合类型中的每个成员都具备相同的异步接口(即都能返回 promise),并在调用前通过类型守卫区分具体类型,从而让 await 能正确解析出对应的值。

如何定义支持 await 的联合类型
要让联合类型支持 await,必须保证联合中的每个分支都是可等待的。通常的做法是将具体的数据对象包裹在 Promise 中,或者定义一个包含 then 方法的接口。这样 TypeScript 才能识别该类型为 Thenable,进而允许使用 await 关键字进行解包。

interface DataResult {
data: string;
}
// 定义联合类型:可以是直接的数据,也可以是 Promise<数据>
type AsyncData = DataResult | Promise<DataResult>;
async function processInput(input: AsyncData): Promise<void> {
// 这里可以直接 await,因为 TS 知道它是 Thenable 或 数据
const result = await input;
console.log(result.data);
}
如何在运行时处理不同类型的返回值
虽然类型系统允许 await,但在运行时需要明确当前值是原始对象还是 Promise 实例。如果联合类型中包含非 Promise 的直接值,直接使用 await 会静默返回该值,但为了逻辑清晰,建议在代码中显式判断。通过检查对象是否具有 then 方法或使用 instanceof Promise 来区分路径,确保后续逻辑针对正确的数据结构执行。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
立即学习“Java免费学习笔记(深入)”;

function handleMixedInput(input: AsyncData) {
if (input instanceof Promise) {
return input.then(res => res.data);
}
return input.data;
}
// 结合 async/await 的使用场景
async function fetchAndProcess(source: AsyncData) {
const resolved = await source;
// resolved 此时一定是 DataResult 类型
return resolved.data.toUpperCase();
}
当联合类型包含 null 或 undefined 时如何处理
如果联合类型中除了 Promise 和数据外还包含 null 或 undefined,直接 await 会导致类型收窄失败或运行时错误。必须在 await 之前先过滤掉空值,或者使用可选链操作符。例如,若输入可能是 Promise<dataresult null></dataresult>,await 后得到的是 DataResult | null,此时需立即进行空值检查,避免对 null 访问属性。

















