diff -r 000000000000 -r 6474c204b198 addon-sdk/source/lib/sdk/deprecated/memory.js
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/addon-sdk/source/lib/sdk/deprecated/memory.js	Wed Dec 31 06:09:35 2014 +0100
@@ -0,0 +1,129 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+"use strict";
+
+module.metadata = {
+  "stability": "deprecated"
+};
+
+const { Cc, Ci, Cu, components } = require("chrome");
+const { when: unload } = require("../system/unload")
+
+var trackedObjects = {};
+const Compacter = {
+  notify: function() {
+    var newTrackedObjects = {};
+
+    for (let name in trackedObjects) {
+      let oldBin = trackedObjects[name];
+      let newBin = [];
+      let strongRefs = [];
+
+      for (let i = 0, l = oldBin.length; i < l; i++) {
+        let strongRef = oldBin[i].weakref.get();
+
+        if (strongRef && strongRefs.indexOf(strongRef) == -1) {
+          strongRefs.push(strongRef);
+          newBin.push(oldBin[i]);
+        }
+      }
+
+      if (newBin.length)
+        newTrackedObjects[name] = newBin;
+    }
+
+    trackedObjects = newTrackedObjects;
+  }
+};
+
+var timer = Cc["@mozilla.org/timer;1"]
+            .createInstance(Ci.nsITimer);
+timer.initWithCallback(Compacter,
+                       5000,
+                       Ci.nsITimer.TYPE_REPEATING_SLACK);
+
+function track(object, bin, stackFrameNumber) {
+  var frame = components.stack.caller;
+  var weakref = Cu.getWeakReference(object);
+
+  if (!bin && 'constructor' in object)
+    bin = object.constructor.name;
+  if (bin == "Object")
+    bin = frame.name;
+  if (!bin)
+    bin = "generic";
+  if (!(bin in trackedObjects))
+    trackedObjects[bin] = [];
+
+  if (stackFrameNumber > 0)
+    for (var i = 0; i < stackFrameNumber; i++)
+      frame = frame.caller;
+
+  trackedObjects[bin].push({weakref: weakref,
+                            created: new Date(),
+                            filename: frame.filename,
+                            lineNo: frame.lineNumber,
+                            bin: bin});
+}
+exports.track = track;
+
+var getBins = exports.getBins = function getBins() {
+  var names = [];
+  for (let name in trackedObjects)
+    names.push(name);
+  return names;
+};
+
+function getObjects(bin) {
+  var results = [];
+
+  function getLiveObjectsInBin(bin) {
+    for (let i = 0, l = bin.length; i < l; i++) {
+      let object = bin[i].weakref.get();
+
+      if (object) {
+        results.push(bin[i]);
+      }
+    }
+  }
+
+  if (bin) {
+    if (bin in trackedObjects)
+      getLiveObjectsInBin(trackedObjects[bin]);
+  }
+  else {
+    for (let name in trackedObjects)
+      getLiveObjectsInBin(trackedObjects[name]);
+  }
+
+  return results;
+}
+exports.getObjects = getObjects;
+
+function gc() {
+  // Components.utils.forceGC() doesn't currently perform
+  // cycle collection, which means that e.g. DOM elements
+  // won't be collected by it. Fortunately, there are
+  // other ways...
+  var test_utils = Cc["@mozilla.org/appshell/appShellService;1"]
+               .getService(Ci.nsIAppShellService)
+               .hiddenDOMWindow
+               .QueryInterface(Ci.nsIInterfaceRequestor)
+               .getInterface(Ci.nsIDOMWindowUtils);
+  test_utils.garbageCollect();
+  // Clean metadata for dead objects
+  Compacter.notify();
+  // Not sure why, but sometimes it appears that we don't get
+  // them all with just one CC, so let's do it again.
+  test_utils.garbageCollect();
+};
+exports.gc = gc;
+
+unload(_ => {
+  trackedObjects = {};
+  if (timer) {
+    timer.cancel();
+    timer = null;
+  }
+});