Publish Vulpes Preview 15 sources for desktop, Android and Tundra

Share Gaia assets and adapters, keep private profiles and development documents local, and update both public READMEs.

gaia/tests/jsmarionette/plugins/marionette-apps/lib/bootwatcher.js

@@ -0,0 +1,79 @@
+'use strict';
+/**
+ * @fileoverview Simple tool to notify listeners when a Firefox OS instance
+ *     finishes booting.
+ */
+var EventEmitter = require('events').EventEmitter;
+
+/**
+ * @constructor
+ * @param {Marionette.Client} client Marionette client to use.
+ */
+function BootWatcher(client) {
+  EventEmitter.call(this, arguments);
+  this._client = client;
+}
+module.exports = BootWatcher;
+
+/**
+ * Initialize the BootWatcher plugin!
+ * @param {Marionette.Client} client Marionette client to use.
+ * @param {Object} options Optional map of attributes for MarionetteApps.
+ * @param {Function} cb Optional callback function to call after setup.
+ * @return {BootWatcher} instance of bootwatcher.
+ */
+BootWatcher.setup = function(client, options, cb) {
+  var bootwatcher = new BootWatcher(client);
+  if (arguments.length === 2 && typeof(options) === 'function') {
+    cb = options;
+    options = undefined;
+  }
+
+  process.nextTick(function() {
+    // wait until client is booted up
+    try {
+      bootwatcher.start();
+    } catch (error) {
+      console.error('Never saw webapps-registry-ready yes');
+    } finally {
+      bootwatcher.emit('boot');
+      if (cb) {
+        cb(null, bootwatcher);
+      }
+    }
+  });
+
+  return bootwatcher;
+};
+
+BootWatcher.prototype = {
+  __proto__: EventEmitter.prototype,
+
+  /**
+   * @type {Marionette.Client}
+   * @private
+   */
+  _client: undefined,
+
+  /**
+   * Start watching for when we're booted.
+   * Initially we were watching the window for the 'applicationready'
+   * event. However, some javascript exceptions in the system app may
+   * keep 'applicationready' from being fired, so poll instead. Also,
+   * an error may be thrown while we're executing. In that case, retry.
+   */
+  start: function() {
+    var client = this._client;
+    client.waitFor(function() {
+      return client.executeScript(function() {
+        try {
+          var sessionStorage = window.wrappedJSObject.sessionStorage;
+          var item = sessionStorage.getItem('webapps-registry-ready');
+          return item === 'yes';
+        } catch (error) {
+          return false;
+        }
+      });
+    }, { timeout: 30000 });
+  }
+};