core: add `NativeModule.prototype.deprecate`

Formalize and cleanup handling of deprecated core methods.

1 files changed, 20 insertions, 0 deletions

diff --git a/src/node.js b/src/node.js
index 9b3fdad6d96..b924bd1a000 100644
--- a/src/node.js
+++ b/src/node.js
@@ -569,5 +569,25 @@
     NativeModule._cache[this.id] = this;
   };
 
+  NativeModule.prototype.deprecate = function(method, message) {
+    var original = this.exports[method];
+    var self = this;
+
+    Object.defineProperty(this.exports, method, {
+      enumerable: false,
+      value: function() {
+        message = self.id + '.' + method + ' is deprecated. ' + (message || '');
+
+        if ((new RegExp('\\b' + self.id + '\\b')).test(process.env.NODE_DEBUG))
+          console.trace(message);
+        else
+          console.error(message);
+
+        self.exports[method] = original;
+        return original.apply(this, arguments);
+      }
+    });
+  };
+
   startup();
 });