UTS 内置对象 Console 完全指南:uni-app / uni-app x 跨端日志、断言、计时与分组调试实践
UTS 内置对象 Console 完全指南uni-app / uni-app x 跨端日志、断言、计时与分组调试实践【免费下载链接】uni-appA cross-platform framework using Vue.js项目地址: https://gitcode.com/gh_mirrors/un/uni-appConsole 是 UTS 语言内置的全局对象用于向控制台输出调试信息其 API 设计与 Web 标准的console对象保持一致。本文以 UTS 官方文档 console.md 为核心系统讲解该对象全部 20 个静态方法log、debug、info、warn、error、assert、clear、count、countReset、dir、dirxml、group、groupCollapsed、groupEnd、table、time、timeEnd、timeLog、timeStamp、trace的签名、返回值与各端兼容性并结合仓库示例工程与 UTS 编译原理给出可直接复制到 uvue 页面或 UTS 插件中的实战用法。一、认识 UTS 的 Console 内置对象UTSuni type script是 uni-app 生态中的跨平台强类型语言可编译为 Web/小程序的 JavaScript、Android 的 Kotlin、iOS 的 Swift 以及鸿蒙的 ArkTS详见 UTS 介绍。在 UTS 中Console属于内置对象无需 import 即可直接使用其职责与浏览器控制台一致打印日志、断言检查、计数器、分组、表格化输出、计时与堆栈跟踪。仓库源码中 Console 是使用频率最高的调试设施之一。例如 hello-uvue 入口文件 中大量使用console.log(res)输出 mixin、全局属性等运行结果hello-uts 的语法用例页 使用console.error(testUtsSync, e)打印异常UTS 单元测试插件 Number.uts 用console.warn(num)输出数值断言结果。与 Web 一致UTS 中console.log等方法均按传参顺序把多个对象依次输出到控制台参数类型为(any | null)[]所有方法返回值均为void。二、基础日志输出debug / log / info / warn / error这是日常调试最常用的一组方法用于输出不同级别的日志信息。文档中四个方法签名完全一致error、info、log、warndebug在log基础上增加了一个带Help /的兼容性标注。统一参数说明| 名称 | 类型 | 必填 | 描述 | | :- | :- | :- | :- | | data | (any | null)[] | 是 | 要输出的对象列表。按传参的顺序把对象输出到控制台。 |统一返回值| 类型 | | :- | | void |各方法行为console.debug(...data)在控制台打印 debug 日志console.error(...data)在控制台打印 error 日志console.info(...data)在控制台打印 info 日志console.log(...data)在控制台打印 log 日志console.warn(...data)在控制台打印 warn 日志。兼容性debug/error/info三者在 uni-app x 与 uni-app 两套体系下的兼容矩阵完全一致| uni-app x 兼容性 | Web | Android | iOS | HarmonyOS | | :- | :- | :- | :- | :- | | 支持版本 | 4.0 | 3.90 | 4.11 | 4.61 || uni-app 兼容性UTS 插件 | Android UTS 插件 | iOS UTS 插件 | HarmonyOS UTS 插件 | | :- | :- | :- | :- | | 支持情况 | √ | √ | √ |log与warn的兼容矩阵则略窄目前仅覆盖 Web4.0、Android3.90、iOS4.11三个平台对应 uni-app 侧为 Android/iOS UTS 插件支持√ / √HarmonyOS 未列入以 console.md 原文为准。因此在需要覆盖鸿蒙端的插件中建议优先使用debug、info、error或assert等具备 HarmonyOS 4.61 支持的方法避免使用log/warn造成鸿蒙端输出缺失。实战示例可直接在 uvue 页面script setup languts中使用let res : string hello console console.log(res) // 普通日志 console.debug(res) // debug 级日志 console.info(res) // info 级日志 console.warn(res) // 警告日志 console.error(res) // 错误日志 // 多参数按顺序输出 console.log(userId:, 10001, status:, ok)三、断言与清理assert / clearconsole.assert(condition?, ...data)如果断言condition为false则将一个错误消息写入控制台如果断言为true则没有任何反应。| 名称 | 类型 | 必填 | | :- | :- | :- | | condition | boolean | 否 | | data | (any | null)[] | 是 |返回值void。| uni-app x 兼容性 | Web | Android | iOS | HarmonyOS | | :- | :- | :- | :- | :- | | 支持版本 | 4.0 | x | x | 4.61 || uni-app 兼容性 | Android UTS 插件 | iOS UTS 插件 | HarmonyOS UTS 插件 | | :- | :- | :- | :- | | 支持情况 | x | x | √ |从兼容矩阵可见assert是Web HarmonyOS两个端点支持的方法Android/iOS 原生侧暂不支持。这与 UTS 中 ts 语法在编译到不同平台时的约束有关可参考 uts 与 ts 的差异。let age : number 17 console.assert(age 18, 未满 18 岁校验失败) // age 18向控制台写入错误消息 console.assert(age 0, 年龄不可能为负) // 条件为 true无任何输出console.clear()console.clear()方法清空控制台但前提是该控制台允许清空。无参数返回值void。| uni-app x 兼容性 | Web | Android | iOS | HarmonyOS | | :- | :- | :- | :- | :- | | 支持版本 | 4.0 | x | x | 4.61 || uni-app 兼容性 | Android UTS 插件 | iOS UTS 插件 | HarmonyOS UTS 插件 | | :- | :- | :- | :- | | 支持情况 | x | x | √ |console.log(旧日志) console.clear() // 清空控制台要求控制台允许清空四、计数器count / countResetconsole.count(label?)console.count()方法会记录调用count()的次数同一个label对应的计数会持续累加并输出到控制台。| 名称 | 类型 | 必填 | | :- | :- | :- | | label | string | 否 |返回值void。兼容性同assertWeb 4.0、HarmonyOS 4.61Android/iOS 为 xuni-app 侧仅 HarmonyOS UTS 插件支持√。for (let i 0; i 3; i) { console.count(loop) // 依次输出 loop: 1、loop: 2、loop: 3 } console.count() // 默认 label输出 default: 1console.countReset(label?)重置计数器。此函数有一个可选参数label不传时重置默认计数。| 名称 | 类型 | 必填 | | :- | :- | :- | | label | string | 否 |返回值void。兼容性同countWeb 4.0、HarmonyOS 4.61uni-app 侧 HarmonyOS UTS 插件 √。console.count(retry) // retry: 1 console.count(retry) // retry: 2 console.countReset(retry)// 重置 retry 计数器 console.count(retry) // retry: 1五、对象检视dir / dirxmlconsole.dir(item?, options?)console.dir()方法可以显示指定对象的属性列表并以交互式的形式展现便于展开查看嵌套结构。| 名称 | 类型 | 必填 | | :- | :- | :- | | item | any | null | 否 | | options | any | null | 否 |返回值void。兼容性Web 4.0、HarmonyOS 4.61Android/iOS xuni-app 侧 HarmonyOS UTS 插件 √。console.dirxml(...data)显示一个明确的 XML/HTML 元素的包括所有后代元素的交互树。非标准该特性是非标准的请尽量不要在生产环境中使用它| 名称 | 类型 | 必填 | | :- | :- | :- | | data | (any | null)[] | 是 |返回值void。兼容性Web 4.0、HarmonyOS 4.61Android/iOS xuni-app 侧 HarmonyOS UTS 插件 √。const user : UTSJSONObject { name: zhangsan, age: 12, address: { city: beijing } } console.dir(user) // 以可展开的属性列表形式展示对象六、日志分组group / groupCollapsed / groupEndconsole.group(...data)方法在控制台上创建一个新的分组。随后输出到控制台上的内容都会被添加一个缩进表示该内容属于当前分组直到调用console.groupEnd()之后当前分组结束。console.groupCollapsed(...data)同样创建新分组区别在于默认折叠console.groupEnd()在控制台中退出一格缩进结束分组。参数group/groupCollapsed的data为(any | null)[]必填groupEnd()无参数。三者返回值均为void兼容性均为 Web 4.0、HarmonyOS 4.61Android/iOS xuni-app 侧 HarmonyOS UTS 插件 √。console.group(订单处理) console.log(开始下单) console.groupCollapsed(子步骤) console.log(校验库存) console.log(扣减库存) console.groupEnd() // 结束子分组退出一格缩进 console.log(下单完成) console.groupEnd() // 结束外层分组七、表格化输出tableconsole.table(tabularData?, properties?)将数据以表格的形式显示适合打印对象数组等结构化数据。| 名称 | 类型 | 必填 | | :- | :- | :- | | tabularData | any | null | 否 | | properties | string[] | 否 |返回值void。兼容性Web 4.0、HarmonyOS 4.61Android/iOS xuni-app 侧 HarmonyOS UTS 插件 √。const list : ArrayUTSJSONObject [ { name: apple, price: 5.5 }, { name: banana, price: 3.2 } ] console.table(list) // 以表格显示两行数据 console.table(list, [name])// 仅显示 name 列八、计时器time / timeEnd / timeLog / timeStampconsole.time(label?)你可以启动一个计时器来跟踪某一个操作的占用时长。每一个计时器必须拥有唯一的名字页面中最多能同时运行 10,000 个计时器。| 名称 | 类型 | 必填 | | :- | :- | :- | | label | string | 否 |console.timeEnd(label?)停止一个通过console.time()启动的计时器并输出该计时器从启动到结束的耗时。非标准该特性是非标准的请尽量不要在生产环境中使用它| 名称 | 类型 | 必填 | | :- | :- | :- | | label | string | 否 |console.timeLog(label?, ...data)在控制台输出计时器的当前值该计时器必须已经通过console.time()启动可附带额外的data一起输出。| 名称 | 类型 | 必填 | | :- | :- | :- | | label | string | 否 | | data | (any | null)[] | 是 |console.timeStamp(label?)非标准该特性是非标准的请尽量不要在生产环境中使用它| 名称 | 类型 | 必填 | | :- | :- | :- | | label | string | 否 |四个方法返回值均为void兼容性均为 Web 4.0、HarmonyOS 4.61Android/iOS xuni-app 侧 HarmonyOS UTS 插件 √。console.time(render) // 模拟耗时操作 let sum : number 0 for (let i 0; i 10000; i) { sum i } console.timeLog(render, 中间进度) // 输出当前计时值 console.timeEnd(render) // 停止计时并输出总耗时 console.timeStamp(用户点击事件) // 在时间线中打一个标记非标准九、堆栈跟踪traceconsole.trace(...data)向控制台输出一个堆栈跟踪用于排查这段代码是从哪里被调用的。| 名称 | 类型 | 必填 | | :- | :- | :- | | data | (any | null)[] | 是 |返回值void。兼容性Web 4.0、HarmonyOS 4.61Android/iOS xuni-app 侧 HarmonyOS UTS 插件 √。function fnA() : void { fnB() } function fnB() : void { console.trace(trace from fnB) // 输出当前调用栈 } fnA()十、兼容性全景与选型建议综合 console.md 的兼容性矩阵可将全部方法归纳为两组| 方法 | uni-app x 支持Web / Android / iOS / HarmonyOS | uni-app UTS 插件支持 | | :- | :- | :- | | debug、error、info | 4.0 / 3.90 / 4.11 / 4.61 | Android √、iOS √、HarmonyOS √ | | log、warn | 4.0 / 3.90 / 4.11HarmonyOS 未列入 | Android √、iOS √ | | assert、clear、count、countReset、dir、dirxml、group、groupCollapsed、groupEnd、table、time、timeEnd、timeLog、timeStamp、trace | 4.0 / x / x / 4.61 | HarmonyOS √Android/iOS 为 x |选型建议全端含鸿蒙日志优先debug、info、errorlog/warn目前未覆盖 HarmonyOS跨端插件需谨慎使用原生端Android/iOS插件基础日志请使用debug/error/info/log/warn其余高级方法断言、计时、分组等在 Android/iOS 原生侧暂为 x可改用条件编译或平台原生日志能力实现Web 鸿蒙assert、count、table、time等高级调试方法均有支持是这两端调试利器。十一、仓库中的真实用法参考hello-uvue 工程入口在 mixin 初始化、全局属性回调等场景中高频使用console.log(res)输出运行结果hello-uts 语法用例页在 UTS 类实例化、Setter 调用等测试用例中用console.error(testUtsSync, e)捕获并输出异常信息UTS 单元测试插件 Number.uts用console.warn(num)输出测试数值验证 UTS 数值类型的字面量推导行为UTS 语言介绍文档中大量console.log示例演示变量、类型判断Array.isArray、instanceof与安全调用?.的调试输出方式Timers 内置对象文档展示在setTimeout/setInterval回调中配合console.log输出定时器 ID 的完整页面级示例可作为 uvue 页面中调试异步逻辑的参考模板。十二、参见完整 API 定义Console 内置对象文档相关 Bug 反馈入口文档末参见一节链接至 DCloud 官方问题跟踪系统uts.buildInObject.Console分类语言背景UTS 语言介绍、uts 与 ts 的差异其他内置对象内置对象 API 文档目录含 Array、Date、Map、Set、JSON、Promise 等 27 个对象【免费下载链接】uni-appA cross-platform framework using Vue.js项目地址: https://gitcode.com/gh_mirrors/un/uni-app创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

NetSuite与用友ERP对比:会计账簿科目与对账

NetSuite与用友ERP对比:会计账簿科目与对账

简介:面向中外会计信息系统比较的学术文献PDF,聚焦Oracle-NetSuite ERP与用友ERP在系统结构与应用理念上的差异,适合会计信息化学习者、ERP实施顾问及企业财务管理人员作为延伸阅读与参考。资源为单个PDF文件,容量868KB&#xff0…

2026/11/11 10:30:21 阅读更多 →
从RGB到多光谱:图像处理的光谱维度与波段组合实战

从RGB到多光谱:图像处理的光谱维度与波段组合实战

简介:这是一份面向高校图像处理课程教学的彩色与多光谱图像处理演示文稿教案,适合教师备课、学生复习以及相关领域工程入门者参考。课件共114页,从人眼彩色视觉原理起步,系统讲解三基色原理、相加混色与相减混色、CIE色度图以及亮…

2026/11/16 0:06:15 阅读更多 →
进步强迫症:当代人的自我成长困境与出路

进步强迫症:当代人的自我成长困境与出路

1. 现象观察:当进步变成自我压迫的工具当代社会普遍存在一种将"进步"神圣化的倾向——我们习惯性地认为个人必须不断突破自我、持续优化、永远向前。这种思维模式表面上积极向上,实际上却可能演变为一种精神暴力。我注意到身边越来越多的人陷入…

2026/10/26 9:43:54 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/16 8:22:12 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/16 8:22:12 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/16 8:22:12 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/16 8:22:12 阅读更多 →

日新闻

周新闻

月新闻