HarmonyOS TypeUtil 基础类型检测详解：isBoolean/isNumber/isString/isObject/isArray 完整教程

背景

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

案例demo导航展示

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

方法总览

为什么需要 TypeUtil？

先看看typeof的局限性：

typeof true → 'boolean' ✓ typeof 42 → 'number' ✓ typeof 'hello' → 'string' ✓ typeof null → 'object' ✗（应该是null） typeof [] → 'object' ✗（应该是array） typeof new Date → 'object' ✗（应该是date）

TypeUtil解决的就是这些问题，每个类型都有专属的判断方法，返回true/false，精准可靠。

isBoolean — 判断布尔值

this.Btn('isBoolean(true) → true','#4A90E2',()=>{this.addLog(`isBoolean(true) →${TypeUtil.isBoolean(true)}`);})this.Btn('isBoolean("true") → false','#4A90E2',()=>{this.addLog(`isBoolean("true") →${TypeUtil.isBoolean("true")}`);})

运行结果：

isBoolean(true) → true isBoolean("true") → false

字符串"true"不是布尔值，isBoolean返回false——这正是我们想要的精确判断。

isNumber — 判断数字

this.Btn('isNumber(42) → true','#5A8DEE',()=>{this.addLog(`isNumber(42) →${TypeUtil.isNumber(42)}`);})this.Btn('isNumber("42") → false','#5A8DEE',()=>{this.addLog(`isNumber("42") →${TypeUtil.isNumber("42")}`);})

运行结果：

isNumber(42) → true isNumber("42") → false

字符串"42"不是数字类型，返回false。

isString — 判断字符串

this.Btn('isString("hello") → true','#27AE60',()=>{this.addLog(`isString("hello") →${TypeUtil.isString("hello")}`);})this.Btn('isString(123) → false','#27AE60',()=>{this.addLog(`isString(123) →${TypeUtil.isString(123)}`);})

运行结果：

isString("hello") → true isString(123) → false

isObject — 判断对象

interfaceSampleObj{a:number;}this.Btn('isObject({a:1}) → true','#E67E22',()=>{constobj:SampleObj={a:1};this.addLog(`isObject({a:1}) →${TypeUtil.isObject(obj)}`);})

运行结果：

isObject({a:1}) → true

注意：isObject对纯对象返回true，但不包含数组（数组有专属的isArray）。

isArray — 判断数组

this.Btn('isArray([1,2,3]) → true','#E74C3C',()=>{this.addLog(`isArray([1,2,3]) →${TypeUtil.isArray([1,2,3])}`);})this.Btn('isArray({}) → false','#E74C3C',()=>{constobj:SampleObj={a:0};this.addLog(`isArray({}) →${TypeUtil.isArray(obj)}`);})

运行结果：

isArray([1,2,3]) → true isArray({}) → false

这就解决了typeof [] === 'object'的歧义问题，用isArray才是精准判断。

isFunction — 判断函数

this.Btn('isFunction(() => {}) → true','#9B59B6',()=>{this.addLog(`isFunction(()=>{}) →${TypeUtil.isFunction(()=>{})}`);})this.Btn('isFunction("str") → false','#9B59B6',()=>{this.addLog(`isFunction("str") →${TypeUtil.isFunction("str")}`);})

运行结果：

isFunction(()=>{}) → true isFunction("str") → false

isResource / isResourceStr — HarmonyOS 特有！

这是TypeUtil里比较有意思的两个方法，专门针对 HarmonyOS 的Resource类型：

// 判断是否是 Resource 对象（$r() 返回的）this.Btn('isResource($r("app.string.app_name")) → true','#7B68EE',()=>{constres=$r('app.string.app_name');this.addLog(`isResource($r("app.string.app_name")) →${TypeUtil.isResource(res)}`);})this.Btn('isResource("plain string") → false','#7B68EE',()=>{this.addLog(`isResource("plain string") →${TypeUtil.isResource("plain string")}`);})// ResourceStr 可以是普通字符串或 Resource 对象this.Btn('isResourceStr("text") → true','#6C5CE7',()=>{this.addLog(`isResourceStr("text") →${TypeUtil.isResourceStr("text")}`);})this.Btn('isResourceStr($r("app.string.app_name")) → true','#6C5CE7',()=>{constres=$r('app.string.app_name');this.addLog(`isResourceStr($r(...)) →${TypeUtil.isResourceStr(res)}`);})

运行结果：

isResource($r("app.string.app_name")) → true isResource("plain string") → false isResourceStr("text") → true isResourceStr($r(...)) → true

区别在于：

• isResource()：只有$r()或$rawfile()返回的 Resource 对象才是true
• isResourceStr()：普通字符串或 Resource 对象都算true（因为ResourceStr = string | Resource）

这在封装通用组件时特别有用，组件参数可能接受ResourceStr，需要在内部判断到底是哪种类型来做不同处理。

实际使用示例

// 处理 ResourceStr 类型参数的通用函数functiongetText(value:ResourceStr):string{if(TypeUtil.isResource(value)){// 是资源引用，需要通过资源管理器获取returngetContext().resourceManager.getStringSync(valueasResource);}else{// 是普通字符串，直接返回returnvalueasstring;}}

总结对比

对于isObject和isArray，用 TypeUtil 比 typeof 可靠得多。

写在最后

类型检测看起来简单，但typeof的坑是真实存在的。TypeUtil 把这些边界情况都处理好了，用起来放心。

特别推荐记住isResource和isResourceStr——这是 HarmonyOS 特有的，处理$r()资源引用时经常用到。