From 7bd8a5a2a60b75266f89f9a32877d55294a3881c Mon Sep 17 00:00:00 2001 From: isaacs Date: Sun, 28 Apr 2013 22:10:24 -0700 Subject: [PATCH] doc: Deprecate require.extensions --- doc/api/globals.markdown | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/api/globals.markdown b/doc/api/globals.markdown index 456289cbb9f..c0ff6b560c6 100644 --- a/doc/api/globals.markdown +++ b/doc/api/globals.markdown @@ -65,12 +65,24 @@ value from this object, the next `require` will reload the module. * {Array} + Stability: 0 - Deprecated + Instruct `require` on how to handle certain file extensions. Process files with the extension `.sjs` as `.js`: require.extensions['.sjs'] = require.extensions['.js']; +**Deprecated** In the past, this list has been used to load +non-JavaScript modules into Node by compiling them on-demand. +However, in practice, there are much better ways to do this, such as +loading modules via some other Node program, or compiling them to +JavaScript ahead of time. + +Since the Module system is locked, this feature will probably never go +away. However, it may have subtle bugs and complexities that are best +left untouched. + ## __filename