【日志打印&定时器相关问题】非必填参数未提供默认值默认说明等内容；各接口功能描述和含义、示例不易理解；多个接口未提供示例代码

## 日志打印

### 没有对日志各个级别含义及使用场景的说明
比如像Hilog里[LogLevel](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/reference/apis/js-apis-hilog.md/#loglevel)这种

### console.debug和console.log都是打印debug级别的日志吗

![输入图片说明](https://foruda.gitee.com/images/1682414480199376700/b4ab03ce_9169901.png "屏幕截图")
![输入图片说明](https://foruda.gitee.com/images/1682414489612672339/e9154968_9169901.png "屏幕截图")

### console.error后面为啥跟着info日志在IDE上筛选显示结果

![输入图片说明](https://foruda.gitee.com/images/1682475232149036672/40da9ebd_9169901.png "屏幕截图")

### console.assert相关描述不完整不清晰

- value的类型是Object，为啥描述里写的是若value为假？说明里写的值，什么值？
- 此参数非必填，未在说明里提供不填的默认值及默认含义，接口的默认处理逻辑等相关内容
- arguments也有同样的问题，对应类型是Object，非必填 --- 说明是错误消息打印？很奇怪啊
- 结合示例也很疑惑

### console.count
- 将默认值说明移到label参数说明处：
![输入图片说明](https://foruda.gitee.com/images/1682475604042521110/1a480ae2_9169901.png "屏幕截图")
- 接口功能描述语义不通顺：
  可以改为：维护一个内部计数器，并输出调用此计数器的次数。
- 但这里“输出调用此计数器的次数”--- 这个次数怎么体现的，返回值不是void吗？
- 整体对这个接口的功能含义和示例代码表示疑惑，看不懂

### console.countReset
- 默认值描述下放到label参数的说明处
- 接口功能含义描述：清除指定计数器的计数。

### console.dir
- 参数dir非必填，但未提供不填时的默认值或默认含义等相关内容 --- 参数非必填时要给出对应不填时候的相关说明，不然让开发者自己摸索这个逻辑吗？ 
- 全文多处涉及此类问题！请整体全量审视并修改！不再一一截图提出！
- 怎么这个接口没有提供对应的示例？

### console.dirxml
- 接口功能描述不清晰，看不懂，怎么跟console.log挂钩的？
- 也没有对应的示例代码

### 文中多个接口未提供非必填参数的相关默认值默认含义等说明

### 文中多个接口，未提供对应的示例代码

### console.group
- 接口描述：将后续航的缩进增加指定长度的空格。
- groupIndentataion是什么，哪来的，文档中根本看不出来啊
- arguments非必填，不填时候的默认含义默认逻辑是怎么样

### console.groupCollapsed
- 与console.group的区别和联系是怎么样的？
- 直接就是group的别名？
- 没有示例

### console.groupEnd
- grounpIndentataion是什么

### console.table
- tableData非必填，未提供相关不填的含义说明等

### console.time
- 启动可用于计算操作持续时间的计时器。可使用[console.timeEnd()](#consoletimeend10)关闭计时器并打印结果。
- label - 计时器标签名，这里怎么又变成了计时器标识了，全文统一概念。默认为'default'。
### console.timeEnd
- 返回值不是void吗？怎么做到输出结果的啊？
- 示例里写的 // abc:225.438ms 这是输出结果的形式？跟上一点一起，很疑惑
![输入图片说明](https://foruda.gitee.com/images/1682479193793650946/052a3b0e_9169901.png "屏幕截图")

### console.timeLog
- label和aguments非必填，非提供不填时的默认值默认说明等内容
- 示例里的const value = aaa();为啥就返回17了？

### console.trace
- arguements参数非必填，未提供不填时的默认值默认说明等内容
- 示例代码对应没有输出结果吗？

## 定时器

### setTimeout参数handler和delay的说明待优化
![输入图片说明](https://foruda.gitee.com/images/1682414754237629015/3dd54b51_9169901.png "屏幕截图")
![输入图片说明](https://foruda.gitee.com/images/1682414788819493621/b3660a19_9169901.png "屏幕截图")

### setTimeout返回参数说明优化
![输入图片说明](https://foruda.gitee.com/images/1682414908661894073/2700eb05_9169901.png "屏幕截图")

### setInternal参数handler和delay的优化
![输入图片说明](https://foruda.gitee.com/images/1682414987057962569/0909095c_9169901.png "屏幕截图")

### setInterval返回值的说明优化
intervalID这个是不是可以去掉啊
![输入图片说明](https://foruda.gitee.com/images/1682415046652768739/2dcd4b9b_9169901.png "屏幕截图")

OpenHarmony/docs
关闭

内容风险标识

评论 (0)

OpenHarmony/docs关闭 .gitee-modal { width: 500px !important; }

内容风险标识