HarmonyOS ArkTS 判断 Promise 与异步函数的正确姿势：TypeUtil 实战教程

背景

近期发现一款很有意思的HarmonyOS 三方库, 地址 @pura/harmony-utils(V1.4.0) , 作者是"桃花镇童长老", 我这里也是直接通过该作者公布的源码进行案例编写进行,写了到目前写了一部分demo ,感觉确实很有帮助,这里呢也是开始写一个系列的演示demo 供大家参考。如有帮助可以在OpenHarmony中进行下载安装进行使用哦

案例demo导航展示

↓↓↓↓↓↓接下来言归正传 ↓↓↓↓

异步编程是现代应用开发的核心，ArkTS 里async/await和Promise用得相当频繁。

但有时候你拿到一个值，需要判断它是不是 Promise；或者拿到一个函数引用，不知道它是不是 async 函数——这时候 TypeUtil 的isPromise和isAsyncFunction就派上用场了。

方法总览

isPromise — 判断是否是 Promise

this.Btn('isPromise(Promise.resolve()) → true','#8E44AD',()=>{constp=Promise.resolve(1);this.addLog(`isPromise(Promise.resolve()) →${TypeUtil.isPromise(p)}`);})

运行结果：

isPromise(Promise.resolve()) → true

Promise.resolve(1)返回的就是一个 Promise 对象，isPromise返回true。

什么时候用？

写通用 SDK 或框架代码时，参数可能是普通值也可能是 Promise，需要做分支处理：

functionprocessResult(result:number|Promise<number>){if(TypeUtil.isPromise(result)){// 是 Promise，等待结果result.then(value=>{console.log('异步结果:',value);});}else{// 是普通值，直接处理console.log('同步结果:',result);}}

isAsyncFunction — 判断是否是异步函数

// async 函数返回 truethis.Btn('isAsyncFunction(async ()=>{}) → true','#6C3483',()=>{constfn=async()=>{};this.addLog(`isAsyncFunction(async ()=>{}) →${TypeUtil.isAsyncFunction(fn)}`);})// 普通函数返回 falsethis.Btn('isAsyncFunction(()=>{}) → false','#6C3483',()=>{constfn=()=>{};this.addLog(`isAsyncFunction(()=>{}) →${TypeUtil.isAsyncFunction(fn)}`);})

运行结果：

isAsyncFunction(async ()=>{}) → true isAsyncFunction(()=>{}) → false

async () => {}是异步函数，返回true；普通箭头函数() => {}返回false。

理解 async 函数的本质：

async函数调用后永远返回一个 Promise，即使函数体里没有await：

constfn=async()=>42;constresult=fn();// result 是 Promise<number>，不是 42！TypeUtil.isPromise(result);// → trueTypeUtil.isAsyncFunction(fn);// → true

所以isAsyncFunction的意义在于：在函数被调用之前，提前判断它是不是异步的，方便做统一的异步处理逻辑。

实际使用场景：

插件系统或回调框架里，支持用户传入同步或异步的回调函数：

asyncfunctionrunCallback(callback:Function){if(TypeUtil.isAsyncFunction(callback)){// 是异步函数，await 等待awaitcallback();}else{// 是同步函数，直接调用callback();}}

isNativeError — 判断是否是原生 Error 对象

this.Btn('isNativeError(new Error("err")) → true','#C0392B',()=>{this.addLog(`isNativeError(new Error()) →${TypeUtil.isNativeError(newError('err'))}`);})this.Btn('isNativeError("string") → false','#C0392B',()=>{this.addLog(`isNativeError("string") →${TypeUtil.isNativeError("string")}`);})

运行结果：

isNativeError(new Error()) → true isNativeError("string") → false

为什么需要这个？

HarmonyOS（以及 JavaScript 标准）中，catch捕获的值类型不确定：

try{// 某些代码}catch(e){// e 的类型是 unknown// 可能是 Error 对象// 也可能是字符串 throw "error message"// 还可能是数字 throw 404}

用isNativeError可以精确判断：

try{someDangerousOperation();}catch(e){if(TypeUtil.isNativeError(e)){// 是 Error 对象，可以安全访问 .message、.stackconsole.log('Error:',(easError).message);console.log('Stack:',(easError).stack);}else{// 不是标准 Error，可能是字符串等console.log('Unknown error:',e);}}

组合使用：处理不确定类型的函数参数

下面是一个综合运用的例子——处理一个可能是值、Promise、或者函数的参数：

asyncfunctionresolveValue(input:number|Promise<number>|(()=>number)|(()=>Promise<number>)):Promise<number>{if(TypeUtil.isPromise(input)){// 已经是 Promisereturnawaitinput;}elseif(TypeUtil.isAsyncFunction(input)){// 是异步函数，调用并等待returnawait(inputas()=>Promise<number>)();}elseif(TypeUtil.isFunction(input)){// 是同步函数，直接调用return(inputas()=>number)();}else{// 是普通值returninputasnumber;}}

所有 TypeUtil 方法速查表

到这里把 TypeUtil 的主要方法都覆盖了，汇总一下：

基础类型：

容器类型：

特殊对象：

异步/函数：

写在最后

isPromise和isAsyncFunction是异步编程里的好帮手，特别是在写框架、SDK、或者通用工具函数时，需要对参数类型做分支处理的场景非常多。

isNativeError也建议养成习惯，在catch块里用它检查一下，写出更健壮的错误处理代码。