From d8290286b310cb8aed289f869444e0ada9b21465 Mon Sep 17 00:00:00 2001 From: Benjamin Gruenbaum Date: Wed, 27 Jan 2016 15:05:43 +0200 Subject: [PATCH] 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 Reviewed-By: Roman Reiss --- doc/api/util.markdown | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/api/util.markdown b/doc/api/util.markdown index ab201c78299..c059be8c0dd 100644 --- a/doc/api/util.markdown +++ b/doc/api/util.markdown @@ -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