Support javascript gtests in an extension background page.

chrome/test/data/webui/test_api.js

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 /**
  * @fileoverview Library providing basic test framework functionality.
  */
 
 /**
  * Namespace for |Test|.
@@ skipping 69 matching lines @@
      * generation inside the function, and after any generated C++.
      * @type {function(string,string)}
      */
     testGenPostamble: null,
 
     /**
      * When set to a non-null string, auto-generate typedef before generating
      * TEST*: {@code typedef typedefCppFixture testFixture}.
      * @type {string}
      */
     typedefCppFixture: 'WebUIBrowserTest',

[dmazzoni, 2014/06/09 06:59:46]

Should this change or be refactored out?

 
     /**
      * This should be initialized by the test fixture and can be referenced
      * during the test run. It holds any mocked handler methods.
      * @type {?Mock4JS.Mock}
      */
     mockHandler: null,
 
     /**
      * This should be initialized by the test fixture and can be referenced
@@ skipping 687 matching lines @@
   var testIsDone = false;
 
   /**
    * Holds the errors, if any, caught by expects so that the test case can
    * fail. Cleared when results are reported from runTest() or testDone().
    * @type {Array.<Error>}
    */
   var errors = [];
 
   /**
    * URL to dummy WebUI page for testing framework.

[dmazzoni, 2014/06/09 06:59:46]

There's so much webui-specific stuff in here, do you think it would be worth
having a "shared" test_api.js with just common code, and a subclass for webui
and for chromevox? Even if you didn't complete the refactoring now, just
starting things in that direction might help clarify things and might encourage
future refactoring to make it clearer.

    * @type {string}
    */
   var DUMMY_URL = 'chrome://DummyURL';
 
   /**
    * Resets test state by clearing |errors| and |testIsDone| flags.
    */
   function resetTestState() {
     errors.splice(0, errors.length);
     testIsDone = false;
@@ skipping 14 matching lines @@
         ok = createExpect(currentTestCase.tearDown.bind(
             currentTestCase)).call(null) && ok;
 
         if (!ok && result)
           result = [false, errorsToMessage(errors, result[1])];
 
         currentTestCase = null;
       }
       if (!result)
         result = testResult();
-      chrome.send('testResult', result);
+      if (chrome.send) {

[dmazzoni, 2014/06/09 06:59:46]

I think it'd be more clear if you determined whether this was a webui test or a
chromevox test in setup/initialization, and then just switch on that here. But
if not, at least clearly document here that chrome.send is for webui tests, and
so on...

[David Tseng, 2014/06/10 05:35:22]

There are just two instances with probably no more coming, so I'll just document
here.

+        chrome.send('testResult', result);
+      } else if (window.domAutomationController.send) {
+        valueResult = { 'result': result[0], message: result[1]};

[Peter Lundblad, 2014/06/08 23:27:22]

nit: put a space before the last } to be symmetric.

[David Tseng, 2014/06/10 05:35:22]

Done.

+        window.domAutomationController.send(JSON.stringify(valueResult));
+      }
       errors.splice(0, errors.length);
     } else {
       console.warn('testIsDone already');
     }
   }
 
   /**
    * Converts each Error in |errors| to a suitable message, adding them to
    * |message|, and returns the message string.
    * @param {Array.<Error>} errors Array of errors to add to |message|.
@@ skipping 250 matching lines @@
    * @return {boolean} true always to signal successful execution (but not
    *     necessarily successful results) of this test.
    * @see errors
    * @see runTestFunction
    */
   function runTest(isAsync, testFunction, testArguments) {
     // Avoid eval() if at all possible, since it will not work on pages
     // that have enabled content-security-policy.
     var testBody = this[testFunction];    // global object -- not a method.
     var testName = testFunction;
+
+    // Depending on how we were called, |this| might not resolve to the global
+    // context.
+    if (testName == 'RUN_TEST_F' && testBody === undefined)
+      testBody = RUN_TEST_F;
+
     if (typeof testBody === "undefined") {
       testBody = eval(testFunction);
       testName = testBody.toString();
     }
     if (testBody != RUN_TEST_F) {
       console.log('Running test ' + testName);
     }
 
     // Async allow expect errors, but not assert errors.
     var result = runTestFunction(testFunction, testBody, testArguments,
@@ skipping 661 matching lines @@
   exports.TEST = TEST;
   exports.TEST_F = TEST_F;
   exports.RUNTIME_TEST_F = TEST_F;
   exports.GEN = GEN;
   exports.GEN_INCLUDE = GEN_INCLUDE;
   exports.WhenTestDone = WhenTestDone;
 
   // Import the Mock4JS helpers.
   Mock4JS.addMockSupport(exports);
 })(this);