Util

Материал из support.qbpro.ru

These functions are in the module 'util'. Use require('util') to access them.

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

Возвращает форматированную по шаблон строку, используя в качестве первого аргумента шаблон в стиле printf (см. язык С).

Первый аргумент строка, содержащая ноль или более placeholders. Каждый placeholder заменяется конвертированным значением из переданных аргументов. Поддерживаются следующие placeholders:

  • %s - Строка.
  • %d - Число (integer или float).
  • %j - JSON.
  • % - single percent sign ('%'). This does not consume an argument.

Если для placeholder нет соответствующего аргумента, placeholder не заменяется.

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

Если число аргументов больше количесвта placeholder, лишние аргументы будут преобразованы с помощью 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.debug(string)

Синхронная функция вывода. Процесс будет блокирован и string будет незамедлительно выведена в stderr.

require('util').debug('message on stderr');

util.error([...])

Same as util.debug() except this will output all arguments immediately to stderr.

util.puts([...])

A synchronous output function. Will block the process and output all arguments to stdout with newlines after each argument.

util.print([...])

A synchronous output function. Will block the process, cast each argument to a string then output to stdout. Does not place newlines after each argument.

util.log(string)

Output with timestamp on stdout.

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

util.inspect(object, [options])

Возвращает object, представленный в виде строки, очень полезно при отладке.

Необязательные параметры задают различные параметры формирования строки:

  • showHidden - if true then the object's non-enumerable properties will be shown too. Defaults to false.
  • depth - tells inspect how many times to recurse while formatting the object. This is useful for inspecting large complicated *objects. Defaults to 2. To make it recurse indefinitely pass null.
  • colors - if true, then the output will be styled with ANSI color codes. Defaults to false. Colors are customizable, see below.
  • customInspect - if false, then custom inspect() functions defined on the objects being inspected won't be called. Defaults to true.

Example of inspecting all properties of the util object:

var util = require('util');

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

Customizing util.inspect colors

Color output (if enabled) of util.inspect is customizable globally via util.inspect.styles and util.inspect.colors objects.

util.inspect.styles is a map assigning each style a color from util.inspect.colors. Highlighted styles and their default values are: number (yellow) boolean (yellow) string (green) date (magenta) regexp (red) null (bold) undefined (grey) special - only function at this time (cyan) * name (intentionally no styling)

Predefined color codes are: white, grey, black, blue, cyan, green, magenta, red and yellow. There are also bold, italic, underline and inverse codes.

Objects also may define their own inspect(depth) function which util.inspect() will invoke and use the result of when inspecting the object:

var util = require('util');

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

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

util.isArray(object)

Returns true if the given "object" is an Array. false otherwise.

var util = require('util');

util.isArray([])
  // true
util.isArray(new Array)
  // true
util.isArray({})
  // false

util.isRegExp(object)

Returns true if the given "object" is a RegExp. false otherwise.

var util = require('util');

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

util.isDate(object)

Returns true if the given "object" is a Date. false otherwise.

var util = require('util');

util.isDate(new Date())
  // true
util.isDate(Date())
  // false (without 'new' returns a String)
util.isDate({})
  // false

util.isError(object)

Returns true if the given "object" is an Error. false otherwise.

var util = require('util');

util.isError(new Error())
  // true
util.isError(new TypeError())
  // true
util.isError({ name: 'Error', message: 'an error occurred' })
  // false

Не используется util.pump(readableStream, writableStream, [callback])

Stability: 0 - Deprecated:

ВЗАМЕН ИСПОЛЬЗОВАТЬ readableStream.pipe(writableStream)

Read the data from readableStream and send it to the writableStream. When writableStream.write(data) returns false readableStream will be paused until the drain event occurs on the writableStream. callback gets an error as its only argument and is called when writableStream is closed or when an error occurs.

util.inherits(constructor, superConstructor)

Наследует методы прототипа конструктора объекта в другой объект. Прототип конструктора будет установлен для нового объекта, созданного через superConstructor.

As an additional convenience, superConstructor will be accessible through the constructor.super_ property.

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!"