doc: document deprecation of util._extend

Document that util._extend was never intended to be used
and should be considered deprecated.

PR-URL: https://github.com/nodejs/node/pull/4903
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Roman Reiss <me@silverwind.io>
This commit is contained in:
Benjamin Gruenbaum authored and James M Snell committed 2016-03-16 12:55:55 -07:00
1 parent 939d6efe0f
commit d8290286b3
1 file changed
+10
+10
View File
@@ -567,6 +567,16 @@ Deprecated predecessor of `console.log`.
Deprecated predecessor of `console.log`.
## util._extend(obj)
Stability: 0 - Deprecated: Use Object.assign() instead.
`_extend` was never intended to be used outside of internal NodeJS modules. The
community found and used it anyway.
It is deprecated and should not be used in new code. JavaScript comes with very
similar built-in functionality through `Object.assign`.
[`Array.isArray`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/isArray
[constructor]: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Object/constructor
[Customizing `util.inspect` colors]: #util_customizing_util_inspect_colors