稳定性: 4 - 锁定

本节介绍node.js的'util'模块中的函数的使用，通过require('util')访问该模块，如下所示：

const util = require('util');

util 模块原先设计的初衷是用来支持node.js的内部api的。这里的很多的函数对你的程序来说都非常有用。如果你觉得这些函数不能满足你的要求，那你可以写自己的工具函数。我们不希望'util'模块里添加对于node内部函数无用的扩展。

util.debuglog(section)

• section{字符串} 被调试的程序节点部分
• returns: {function} 日志函数

用来创建一个有条件的写到stderr的函数（基于node_debug环境变量）。如果section出现在环境变量里，返回函数将会和console.error()类似。否则，返回一个空函数。

例如：

javascript
var debuglog = util.debuglog('foo');

var bar = 123;
debuglog('hello from foo [%d]', bar);

如果这个程序以node_debug=foo的环境运行，将会输出：

foo 3245: hello from foo [123]

3245是进程id。如果没有运行在这个环境变量里，将不会打印任何东西。

可以用逗号切割多个node_debug环境变量。例如：node_debug=fs,net,tls。

util.format(format[, ...])

使用第一个参数返回一个格式化的字符串，类似printf。

第一个参数是字符串，它包含0或更多的占位符。每个占位符被替换成想要参数转换的值。支持的占位符包括：

• %s- 字符串.
• %d- 数字 (整数和浮点数).
• %j- json。如果参数包含循环引用，将会用字符串替换r
• %%- 单独一个百分号 ('%')。 不会消耗一个参数。

如果占位符没有包含一个相应的参数，占位符不会被替换。

util.format('%s:%s', 'foo'); // 'foo:%s'

如果参数超过占位符，多余的参数将会用util.inspect()转换成字符串，并拼接在一起，用空格隔开。

util.format('%s:%s', 'foo', 'bar', 'baz'); // 'foo:bar baz'

如果第一个参数不是格式化字符串，那么util.format()会返回所有参数拼接成的字符串（空格分割）。每个参数都会用util.inspect()转换成字符串。

util.format(1, 2, 3); // '1 2 3'

util.log(string)

在stdout输出并带有时间戳：

require('util').log('timestamped message.');

util.inspect(object[, options])

返回一个对象的字符串表现形式，在代码调试的时候非常有用。

通过加入一些可选选项，来改变对象的格式化输出形式：

• showhidden- 如果为true，将会显示对象的不可枚举属性。默认为false。

• depth- 告诉inspect格式化对象时递归多少次。这在格式化大且复杂对象时非常有用。默认为 2。如果想无穷递归的话，传null。

• colors- 如果为true，输出内容将会格式化为有颜色的代码。默认为false， 颜色可以自定义，参见下文。

• custominspect- 如果为false，那么定义在被检查对象上的inspect(depth, opts) 方法将不会被调用。 默认为true。

检查util对象上所有属性的例子：

var util = require('util');

console.log(util.inspect(util, { showhidden: true, depth: null }));

当被调用的时候，参数值可以提供自己的自定义inspect(depth, opts)方法。该方法会接收当前的递归检查深度，以及传入util.inspect()的其他参数。

自定义util.inspect颜色

util.inspect通过util.inspect.styles和util.inspect.colors对象，自定义全局的输出颜色，

util.inspect.styles和util.inspect.colors组成风格颜色的一对映射。

高亮风格和他们的默认值：

• 数字 (黄色)
• boolean (黄色)
• 字符串 (绿色)
• date (洋红)
• regexp (红色)
• null (粗体)
• undefined (斜体)
• special (青绿色)
• name (内部用，不是风格)

预定义的颜色为: white、斜体、black、blue、cyan、绿色、洋红、红色和黄色以及粗体、斜体、下划线和反选风格。

对象上德自定义inspect()函数

对象也能自定义inspect(depth)函数， 当使用util.inspect()检查该对象的时候，将会执行对象自定义的检查方法：

var util = require('util');

var obj = { name: 'nate' };
obj.inspect = function(depth) {
  return '{' + this.name + '}';
};

util.inspect(obj);
  // "{nate}"

你可以返回另外一个对象，返回的字符串会根据返回的对象格式化。这和json.stringify()的工作流程类似。您还可以完全返回另一个对象，返回的字符串将根据返回的对象格式化。这与json.stringify()的工作方式类似：

var obj = { foo: 'this will not show up in the inspect() output' };
obj.inspect = function(depth) {
  return { bar: 'baz' };
};

util.inspect(obj);
  // "{ bar: 'baz' }"

util.isarray(object)

array.isarray的内部别名。

如果参数"object"是数组，返回true ，否则返回false。

var util = require('util');

util.isarray([])
  // true
util.isarray(new array)
  // true
util.isarray({})
  // false

util.isregexp(object)

如果参数"object"是regexp返回true ，否则返回false。

var util = require('util');

util.isregexp(/some regexp/)
  // true
util.isregexp(new regexp('another regexp'))
  // true
util.isregexp({})
  // false

util.isdate(object)

如果参数"object"是date返回true，否则返回false。

var util = require('util');

util.isdate(new date())
  // true
util.isdate(date())
  // false (without 'new' returns a string)
util.isdate({})
  // false

util.iserror(object)

如果参数"object"是error返回true，否则返回false。

var util = require('util');

util.iserror(new error())
  // true
util.iserror(new typeerror())
  // true
util.iserror({ name: 'error', message: 'an error occurred' })
  // false

util.inherits(constructor, superconstructor)

从一个构造函数constructor继承原型方法到另一个。构造函数的原型将被设置为一个新的从超类（superconstructor）创建的对象。

通过constructor.super_属性可以访问superconstructor。

var util = require("util");
var events = require("events");

function mystream() {
    events.eventemitter.call(this);
}

util.inherits(mystream, events.eventemitter);

mystream.prototype.write = function(data) {
    this.emit("data", data);
}

var stream = new mystream();

console.log(stream instanceof events.eventemitter); // true
console.log(mystream.super_ === events.eventemitter); // true

stream.on("data", function(data) {
    console.log('received data: "' + data + '"');
})
stream.write("it works!"); // received data: "it works!"

util.deprecate(function, string)

标明该方法不要再使用。

exports.puts = exports.deprecate(function() {
  for (var i = 0, len = arguments.length; i < len; ++i) {
    process.stdout.write(arguments[i] + '\n');
  }
}, 'util.puts: use console.log instead')

返回一个修改过的函数，默认情况下仅警告一次。如果设置了--no-deprecation该函数不做任何事。如果设置了--throw-deprecation，如果使用了该api应用将会抛出异常。

util.debug(string)

稳定性: 0 - 抛弃: 使用 console.error() 替换。

console.error的前身。

util.error([...])

稳定性: 0 - 抛弃: 使用 console.error() 替换。

console.error的前身。

util.puts([...])

稳定性: 0 - 抛弃:使用 console.log() 替换。

console.log的前身。

util.print([...])

稳定性: 0 - 抛弃: 使用 console.log() 替换。

console.log的前身。

util.pump(readablestream, writablestream[, callback])

稳定性: 0 - 抛弃: use readablestream.pipe(writablestream)

stream.pipe的前身。