Skip to content

Commit ae09fc2

Browse files
committed
doc: document deprecation of util._extend
See the discussion here #4593 for more details as well as the 2016-01-20 minutes. PR-URL: #4902 Reviewed-By: Evan Lucas <evanlucas@me.com> Reviewed-By: thefourtheye <thechargingvolcano@gmail.com>
1 parent e99a50d commit ae09fc2

File tree

1 file changed

+12
-1
lines changed

1 file changed

+12
-1
lines changed

doc/api/util.markdown

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -544,10 +544,21 @@ Deprecated predecessor of `console.log`.
544544

545545
## util.puts([...])
546546

547-
Stability: 0 - Deprecated: Use console.log() instead.
547+
Stability: 0 - Deprecated: Use `console.log()` instead.
548548

549549
Deprecated predecessor of `console.log`.
550550

551+
552+
## util._extend(obj)
553+
554+
Stability: 0 - Deprecated: Use Object.assign() instead.
555+
556+
`_extend` was never intended to be used outside of internal NodeJS modules. The
557+
community found and used it.
558+
559+
It is deprecated and should not be used in new code. JavaScript comes with very
560+
similar built in functionality through `Object.assign`.
561+
551562
[`Array.isArray`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/isArray
552563
[constructor]: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Object/constructor
553564
[Customizing `util.inspect` colors]: #util_customizing_util_inspect_colors

0 commit comments

Comments
 (0)