diff --git a/doc/api/util.md b/doc/api/util.md index d183bfec595d87..ace6a7d3d0d9f7 100644 --- a/doc/api/util.md +++ b/doc/api/util.md @@ -11,6 +11,9 @@ const util = require('util'); ``` ## util.debuglog(section) + * `section` {String} A string identifying the portion of the application for which the `debuglog` function is being created. @@ -45,6 +48,9 @@ Multiple comma-separated `section` names may be specified in the `NODE_DEBUG` environment variable. For example: `NODE_DEBUG=fs,net,tls`. ## util.deprecate(function, string) + The `util.deprecate()` method wraps the given `function` or class in such a way that it is marked as deprecated. @@ -83,6 +89,9 @@ property take precedence over `--trace-deprecation` and `process.traceDeprecation`. ## util.format(format[, ...]) + * `format` {string} A `printf`-like format string. @@ -125,6 +134,9 @@ util.format(1, 2, 3); // '1 2 3' ``` ## util.inherits(constructor, superConstructor) + _Note: usage of `util.inherits()` is discouraged. Please use the ES6 `class` and `extends` keywords to get language level inheritance support. Also note that @@ -190,6 +202,9 @@ stream.write('With ES6'); ``` ## util.inspect(object[, options]) + * `object` {any} Any JavaScript primitive or Object. * `options` {Object} @@ -296,6 +311,9 @@ util.inspect(obj); ``` ### util.inspect.defaultOptions + The `defaultOptions` value allows customization of the default options used by `util.inspect`. This is useful for functions like `console.log` or @@ -318,6 +336,10 @@ The following APIs have been deprecated and should no longer be used. Existing applications and modules should be updated to find alternative approaches. ### util.debug(string) + > Stability: 0 - Deprecated: Use [`console.error()`][] instead. @@ -326,6 +348,10 @@ applications and modules should be updated to find alternative approaches. Deprecated predecessor of `console.error`. ### util.error([...]) + > Stability: 0 - Deprecated: Use [`console.error()`][] instead. @@ -334,6 +360,10 @@ Deprecated predecessor of `console.error`. Deprecated predecessor of `console.error`. ### util.isArray(object) + > Stability: 0 - Deprecated @@ -355,6 +385,10 @@ util.isArray({}); ``` ### util.isBoolean(object) + > Stability: 0 - Deprecated @@ -374,6 +408,10 @@ util.isBoolean(false); ``` ### util.isBuffer(object) + > Stability: 0 - Deprecated: Use [`Buffer.isBuffer()`][] instead. @@ -393,6 +431,10 @@ util.isBuffer(Buffer.from('hello world')); ``` ### util.isDate(object) + > Stability: 0 - Deprecated @@ -412,6 +454,10 @@ util.isDate({}); ``` ### util.isError(object) + > Stability: 0 - Deprecated @@ -447,6 +493,10 @@ util.isError(obj); ``` ### util.isFunction(object) + > Stability: 0 - Deprecated @@ -470,6 +520,10 @@ util.isFunction(Bar); ``` ### util.isNull(object) + > Stability: 0 - Deprecated @@ -490,6 +544,10 @@ util.isNull(null); ``` ### util.isNullOrUndefined(object) + > Stability: 0 - Deprecated @@ -510,6 +568,10 @@ util.isNullOrUndefined(null); ``` ### util.isNumber(object) + > Stability: 0 - Deprecated @@ -531,6 +593,10 @@ util.isNumber(NaN); ``` ### util.isObject(object) + > Stability: 0 - Deprecated @@ -553,6 +619,10 @@ util.isObject(function(){}); ``` ### util.isPrimitive(object) + > Stability: 0 - Deprecated @@ -585,6 +655,10 @@ util.isPrimitive(new Date()); ``` ### util.isRegExp(object) + > Stability: 0 - Deprecated @@ -604,6 +678,10 @@ util.isRegExp({}); ``` ### util.isString(object) + > Stability: 0 - Deprecated @@ -625,6 +703,10 @@ util.isString(5); ``` ### util.isSymbol(object) + > Stability: 0 - Deprecated @@ -644,6 +726,10 @@ util.isSymbol(Symbol('foo')); ``` ### util.isUndefined(object) + > Stability: 0 - Deprecated @@ -664,6 +750,10 @@ util.isUndefined(null); ``` ### util.log(string) + > Stability: 0 - Deprecated: Use a third party module instead. @@ -679,18 +769,30 @@ util.log('Timestamped message.'); ``` ### util.print([...]) + > Stability: 0 - Deprecated: Use [`console.log()`][] instead. Deprecated predecessor of `console.log`. ### util.puts([...]) + > Stability: 0 - Deprecated: Use [`console.log()`][] instead. Deprecated predecessor of `console.log`. -### util._extend(obj) +### util.\_extend(obj) + > Stability: 0 - Deprecated: Use [`Object.assign()`] instead.