From 3f73502662b3cf1e5ae1f5da54e8e02ebcb213a2 Mon Sep 17 00:00:00 2001 From: Bryan English Date: Tue, 12 Apr 2016 11:10:49 -0700 Subject: [PATCH] doc: native module reloading is not supported Clarify in docs for require.cache that reloading native modules isn't supported. Related: #6160 PR-URL: https://github.com/nodejs/node/pull/6168 Reviewed-By: Benjamin Gruenbaum Reviewed-By: Brian White Reviewed-By: James M Snell --- doc/api/globals.markdown | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/doc/api/globals.markdown b/doc/api/globals.markdown index 1bee7d0cf988c2..643ab4334b20a6 100644 --- a/doc/api/globals.markdown +++ b/doc/api/globals.markdown @@ -145,7 +145,9 @@ global but rather local to each module. * {Object} Modules are cached in this object when they are required. By deleting a key -value from this object, the next `require` will reload the module. +value from this object, the next `require` will reload the module. Note that +this does not apply to [native addons][], for which reloading will result in an +Error. ### require.extensions @@ -199,6 +201,7 @@ but rather than loading the module, just return the resolved filename. [buffer section]: buffer.html [module system documentation]: modules.html [Modules]: modules.html#modules_modules +[native addons]: addons.html [timers]: timers.html [`clearImmediate`]: timers.html#timers_clearimmediate_immediateobject [`clearInterval`]: timers.html#timers_clearinterval_intervalobject