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/apps/settings/test/unit/toaster_test.js

@@ -0,0 +1,179 @@
+/* global Toaster, MockL10n */
+// Tests the toaster.js from shared
+
+'use strict';
+
+require('/shared/js/toaster.js');
+require('/shared/test/unit/mocks/mock_l20n.js');
+
+var ToasterTestHelper = {
+  thereShouldBeNoToastShowed: function tth_thereShouldBeNoToastShowed(elem) {
+    if (elem) {
+      assert.ok(!elem.classList.contains(Toaster._toastVisibleClass),
+        'element should not have class "' + Toaster._toastVisibleClass + '"');
+    } else {
+      assert.fail(null, null, 'No element');
+    }
+  },
+
+  thereMustHaveToastShowed:
+      function tth_thereMustHaveToastShowed(elem, expectedContent) {
+    if (elem) {
+      assert.ok(elem.classList.contains(Toaster._toastVisibleClass),
+        'element should have class "' + Toaster._toastVisibleClass + '"');
+    } else {
+      assert.fail(null, null, 'No element');
+    }
+  }
+
+};
+
+suite('Toaster', function() {
+  var realMozL10n;
+
+  suiteSetup(function() {
+    realMozL10n = document.l10n;
+    document.l10n = MockL10n;
+  });
+
+  suiteTeardown(function() {
+    document.l10n = realMozL10n;
+  });
+
+  suite(' > Initialize methods', function() {
+    test(' > initialize() with parentElement', function() {
+      var parentElement = document.createElement('div');
+      Toaster.initialize(parentElement);
+      assert.ok(Toaster.containerElement, 'containerElement does not exist');
+      assert.ok(Toaster.messageElement,
+        'messageElement does not exist');
+      ToasterTestHelper.thereShouldBeNoToastShowed(
+        parentElement.getElementsByTagName('section')[0]);
+      Toaster._destroy();
+    });
+
+    test(' > initialize() without parentElement', function() {
+      Toaster.initialize();
+      assert.ok(Toaster.containerElement, 'containerElement does not exist');
+      assert.ok(Toaster.messageElement,
+        'messageElement does not exist');
+      Toaster._destroy();
+    });
+  });
+
+  suite(' > Public methods', function() {
+    setup(function() {
+      Toaster.initialize();
+    });
+
+    teardown(function() {
+      Toaster._destroy();
+    });
+
+    test(' > isInitialized()', function() {
+      ToasterTestHelper.thereShouldBeNoToastShowed(
+        document.querySelector('section[role="status"]'));
+    });
+
+    test(' > showToast()', function() {
+      var expectedContent = 'under testing';
+      Toaster.showToast({
+        messageL10nId: expectedContent,
+        latency: 5000
+      });
+      ToasterTestHelper.thereMustHaveToastShowed(
+        document.querySelector('section[role="status"]'),
+        expectedContent);
+    });
+  });
+
+  suite(' > Private methods', function() {
+    setup(function() {
+      Toaster.initialize();
+      Toaster.showToast({messageL10nId: 'under testing'});
+    });
+
+    teardown(function() {
+      Toaster._destroy();
+    });
+
+    test(' > _isBusy()', function() {
+      assert.ok(Toaster._isBusy(), 'toaster is not busy');
+    });
+
+    test(' > _isBacklogged()', function() {
+      Toaster.showToast({messageL10nId: 'more coming'});
+      assert.ok(Toaster._isBacklogged(), 'toaster is not backlogged');
+    });
+  });
+
+  suite(' > Complex scenarios with time bending', function() {
+    var clock;
+    setup(function() {
+      clock = this.sinon.useFakeTimers();
+      Toaster.initialize();
+    });
+
+    teardown(function() {
+      Toaster._destroy();
+      clock.restore();
+    });
+
+    test(' > show toast once', function() {
+      var expectedContent = 'This should display for only 2 seconds';
+      Toaster.showToast({
+        messageL10nId: expectedContent,
+        latency: 2000
+      });
+      clock.tick(1000);
+      ToasterTestHelper.thereMustHaveToastShowed(
+        document.querySelector('section[role="status"]'),
+        expectedContent);
+      clock.tick(1000);
+      ToasterTestHelper.thereShouldBeNoToastShowed(
+        document.querySelector('section[role="status"]'));
+    });
+
+    test(' > show 3 toasts in a row', function() {
+      var expectedContent = [
+        'The 1st toast should display for only 2 seconds',
+        'The 2nd toast should display for only 3 seconds',
+        'The 3rd toast should display for only 1 seconds'
+      ];
+
+      Toaster.showToast({
+        messageL10nId: expectedContent[0],
+        latency: 2000
+      });
+      Toaster.showToast({
+        messageL10nId: expectedContent[1],
+        latency: 3000
+      });
+      Toaster.showToast({
+        messageL10nId: expectedContent[2],
+        latency: 1000
+      });
+
+      // 1st toast showed
+      clock.tick(1000); // 1.000 second
+      ToasterTestHelper.thereMustHaveToastShowed(
+        document.querySelector('section[role="status"]'), expectedContent[0]);
+      clock.tick(1000); // 2.000 second
+
+      // 2nd toast showed
+      clock.tick(1500); // 3.500 second
+      ToasterTestHelper.thereMustHaveToastShowed(
+        document.querySelector('section[role="status"]'), expectedContent[1]);
+      clock.tick(2000); // 5.500 second
+
+      // 3rd toast showed
+      ToasterTestHelper.thereMustHaveToastShowed(
+        document.querySelector('section[role="status"]'), expectedContent[2]);
+      clock.tick(500);  // 6.000 second
+
+      // all toasts should be cleared
+      ToasterTestHelper.thereShouldBeNoToastShowed(
+        document.querySelector('section[role="status"]'));
+    });
+  });
+});