util · Magic_sword2

[TOC] # 简介说明 原文链接： - [util](https://github.com/nodejs/node/blob/main/doc/api/util.md) ``` 版本：util 作用：用于支持 Node.js 内部 API 的需求 ``` # util # *callbackify() ***** 接受一个异步函数（或返回Promise的函数）并返回一个遵循错误优先回调样式的函数 # *promisify() ***** 将传递的函数promis化 ### 示例内容 1. 举例说明 ``` const { promisify } = require('util') const fs = require('fs') const statAsync = promisify(fs.stat) statAsync('.').then(stats => { // 拿到了正确的数据 }, err => { // 出现了异常 }) ``` # *inspect() ***** 输出带有颜色和风格的内容 ### 参数说明 object: * 类型：对象 * 默认值：无 * 描述：对象 * 可选值：[ ] options: * 类型：对象 * 默认值：无 * 描述：可选参数 * 可选值：[ ] - showHidden：对象的不可枚举符号和属性是否将包含在格式化结果中 - depth：指定格式化对象时递归的次数 - colors：输出将使用ANSI颜色代码进行样式设置 - customInspect：是否允许自定义inspect的样式 - showProxy：Proxy inspection includes the target and handler objects - maxArrayLength：指定格式化时要包括的Array、TypedArray、Map、Set、WeakMap和WeakSet元素的最大数量 - maxStringLength：指定格式化时要包含的最大字符数 - breakLength：输入值跨多行分割的长度 - compact：是否紧密显示输出内容 - sorted：如果设置为true或函数，则对象的所有属性以及set和Map条目将在结果字符串中排序 - getters：如果设置为true，则检查getter - numericSeparator：如果设置为true，则使用下划线分隔所有bigint和数字中的每三位数字 # *formatWithOptions() ***** 格式化输出内容，同时可以配置inspect参数选项 # *format() ***** 格式化输出内容 # *debuglog() | debug() ***** 创建一个函数，该函数根据 `NODE_DEBUG` 环境变量的存在将调试消息有条件地写入stderr ### 示例内容 1. 举例说明 ``` // 环境变量NODE_DEBUG=foo的时候被打印输出 const debuglog = util.debuglog('foo') debuglog('hello from foo [%d]', 123) ``` # *deprecate() ***** 用于装饰一个应该被弃用的方法或函数 # *inherits() ***** 原型链式继承 ### 示例内容 1. 举例说明 ``` var events=require('events'); var util=require('util'); function _base(){ this.emitter=new events.EventEmitter(this); }; util.inherits(_base,events.EventEmitter); //继承 _base.prototype.onEvent=function(eventName,callback){ this.emitter.on(eventName,callback); } _base.prototype.emitEvent=function(eventName,arg){ this.emitter.emit(eventName,arg); } module.exports=_base; ``` # *getSystemErrorName() ***** 获取错误码对应的系统名称 # *getSystemErrorMap() ***** 获取系统错误码和名称的映射对象表 # *isDeepStrictEqual() ***** 两个对象是否深度严格相等 # [fut]-*parseArgs() ***** 参数和配置解析器 # [fut]-*stripVTControlCharacters() ***** 返回删除了任何ANSI转义代码的str # [fut]-*toUSVString() ***** 用Unicode“替换字符”U+FFFD替换任何代理代码点（或等效地，任何未配对的代理代码单元）后返回字符串 # util.types # *isAnyArrayBuffer() ***** 如果值是内置ArrayBuffer或SharedArrayBuffer实例，则返回true # util.TextDecoder # [new]-TextDecoder() ***** WHATWG编码标准文本解码器API的实现 # util.TextEncoder # [new]-TextEncoder() ***** WHATWG编码标准TextEncoder API的实现