Node.js API详解之 util
util 模块主要用于支持 Node.js 内部 API 的需求。提供了大部分实用工具。
通过 const util = require(‘util'); 的方式引用util模块
说明：
original：传递一个 async 函数，或者是一个返回Promise的异步函数。
callbackify会返回一个方法，执行该方法时传递一个回调函数，回调函数的第一个参数是err，第二个是异步函数的返回值。
demo：
const util = require('util'); async function fn() { return await Promise.resolve('hello isjs'); } const callbackFunction = util.callbackify(fn); callbackFunction((err, ret) => { if (err) throw err; console.log(ret); }); //输出： hello isjs
util.debuglog(section)说明：
util.debuglog() 方法用于创建一个函数，基于 NODE_DEBUG 环境变量的存在与否有条件地写入调试信息到 stderr。
如果 section 名称在环境变量的值中，则返回的函数类似于 console.error()。 否则，返回的函数是一个空操作。
section：一个字符串，指定要为应用的哪些部分创建 debuglog 函数。
demo：
const util = require('util'); const debuglog = util.debuglog('foo'); debuglog('hello from foo [%d]', 123);
util.deprecate(function, string)说明：
该方法会包装给定的 function 或类，并标记为废弃的。
demo:
const util = require('util'); function isBoolean(obj){ return (obj === true || obj === false); } isBoolean = util.deprecate(isBoolean, 'isBoolean 方法已被废弃'); isBoolean(true); //输出：(node:9911) DeprecationWarning: isBoolean 方法已被废弃
util.format(format[, …args])说明：
util.format() 方法返回一个格式化后的字符串，
format：第一个参数是一个字符串，包含零个或多个占位符。
每个占位符会被对应参数转换后的值所替换。 支持的占位符有：
%s：字符串
%d：数值（整数或浮点数）
%i：整数
%f：浮点数
%j – JSON
%o – Object（包括不可枚举的属性方法）
%O – Object（不包括不可枚举属性）
%% – 单个百分号（'%'）不消耗参数。
demo：
const util = require('util'); var formatString = util.format('%s %d %i %f %j', 'hello', 1.123, 123, 2.1, "{'name': 'xiao', 'age': '18'}"); console.log(formatString); //e输出： hello 1.123 123 2.1 "{'name': 'xiao', 'age': '18'}" //如果占位符没有对应的参数，则占位符不被替换。 formatString = util.format('%s , %s', 'hello'); console.log(formatString); //输出： hello , %s //如果传入的参数比占位符的数量多，则多出的参数会被强制转换为字符串， //然后拼接到返回的字符串，参数之间用一个空格分隔。 formatString = util.format('%s , %s', 'hello', 'isjs', '!'); console.log(formatString); //输出： hello , isjs ! //如果第一个参数不是一个字符串，则返回一个所有参数用空格分隔并连在一起的字符串 formatString = util.format(1, 2, 3); console.log(formatString); //输出： 1 2 3 //如果只传入占位符而不传入参数，则原样返回 formatString = util.format('%% , %s'); console.log(formatString); //输出： %% , %s
util.inherits(constructor, superConstructor)说明：
注意，不建议使用 util.inherits()。 请使用 ES6 的 class 和 extends 关键词获得语言层面的继承支持。
从一个构造函数中继承原型方法到另一个。
constructor 的 prototype 会被设置到一个从 superConstructor 创建的新对象上。
superConstructor 可通过 constructor.super_ 属性访问
demo：
const util = require('util'); const EventEmitter = require('events'); function MyStream() { EventEmitter.call(this); } util.inherits(MyStream, EventEmitter); MyStream.prototype.write = function(data) { this.emit('data', data); }; const stream = new MyStream(); console.log(stream instanceof EventEmitter); // true console.log(MyStream.super_ === EventEmitter); // true stream.on('data', (data) => { console.log(`接收的数据："${data}"`); }); stream.write('运作良好！'); // 接收的数据："运作良好！" //建议使用 ES6 的 class 和 extends： const EventEmitter = require('events'); class MyStream extends EventEmitter { write(data) { this.emit('data', data); } } const stream = new MyStream(); stream.on('data', (data) => { console.log(`接收的数据："${data}"`); }); stream.write('使用 ES6');
util.inspect(object[, options])说明：
方法返回 object 的字符串表示，主要用于调试。
object: 任何 JavaScript 原始值或对象
options: 可用于改变格式化字符串的某些方面。
demo:
const util = require('util'); const inspectOpt = { showHidden: false,//如果为 true，则 object 的不可枚举的符号与属性也会被包括在格式化后的结果中。 depth: 2,//指定格式化 object 时递归的次数。 默认为 2。 若要无限地递归则传入 null。 colors: false,//如果为 true，则输出样式使用 ANSI 颜色代码。 默认为 false。 customInspect: true,//如果为 false，则 object 上自定义的 inspect(depth, opts) 函数不会被调用。 默认为 true showProxy: false,//如果为 true，则 Proxy 对象的对象和函数会展示它们的 target 和 handler 对象。 默认为 false maxArrayLength: 100,//指定格式化时数组和 TypedArray 元素能包含的最大数量。 默认为 100。 设为 null 则显式全部数组元素。 设为 0 或负数则不显式数组元素。 breakLength: 60//一个对象的键被拆分成多行的长度。 设为 Infinity 则格式化一个对象为单行。 默认为 60。 }; console.log(util.inspect(util, inspectOpt));
util.inspect.styles, util.inspect.colors说明：