summaryrefslogtreecommitdiffstats
path: root/ecomp-portal-FE/client/bower_components/angular-scenario/jstd-scenario-adapter.js
blob: f65afd90f94cfe070b528824e105b79c46d9a1cf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
/**
 * @license AngularJS v1.0.4
 * (c) 2010-2012 Google, Inc. http://angularjs.org
 * License: MIT
 */
(function(window) {
'use strict';

/**
 * JSTestDriver adapter for angular scenario tests
 *
 * Example of jsTestDriver.conf for running scenario tests with JSTD:
  <pre>
    server: http://localhost:9877

    load:
      - lib/angular-scenario.js
      - lib/jstd-scenario-adapter-config.js
      - lib/jstd-scenario-adapter.js
      # your test files go here #

    proxy:
     - {matcher: "/your-prefix/*", server: "http://localhost:8000/"}
  </pre>
 *
 * For more information on how to configure jstd proxy, see {@link http://code.google.com/p/js-test-driver/wiki/Proxy}
 * Note the order of files - it's important !
 *
 * Example of jstd-scenario-adapter-config.js
  <pre>
    var jstdScenarioAdapter = {
      relativeUrlPrefix: '/your-prefix/'
    };
  </pre>
 *
 * Whenever you use <code>browser().navigateTo('relativeUrl')</code> in your scenario test, the relativeUrlPrefix will be prepended.
 * You have to configure this to work together with JSTD proxy.
 *
 * Let's assume you are using the above configuration (jsTestDriver.conf and jstd-scenario-adapter-config.js):
 * Now, when you call <code>browser().navigateTo('index.html')</code> in your scenario test, the browser will open /your-prefix/index.html.
 * That matches the proxy, so JSTD will proxy this request to http://localhost:8000/index.html.
 */

/**
 * Custom type of test case
 *
 * @const
 * @see jstestdriver.TestCaseInfo
 */
var SCENARIO_TYPE = 'scenario';

/**
 * Plugin for JSTestDriver
 * Connection point between scenario's jstd output and jstestdriver.
 *
 * @see jstestdriver.PluginRegistrar
 */
function JstdPlugin() {
  var nop = function() {};

  this.reportResult = nop;
  this.reportEnd = nop;
  this.runScenario = nop;

  this.name = 'Angular Scenario Adapter';

  /**
   * Called for each JSTD TestCase
   *
   * Handles only SCENARIO_TYPE test cases. There should be only one fake TestCase.
   * Runs all scenario tests (under one fake TestCase) and report all results to JSTD.
   *
   * @param {jstestdriver.TestRunConfiguration} configuration
   * @param {Function} onTestDone
   * @param {Function} onAllTestsComplete
   * @returns {boolean} True if this type of test is handled by this plugin, false otherwise
   */
  this.runTestConfiguration = function(configuration, onTestDone, onAllTestsComplete) {
    if (configuration.getTestCaseInfo().getType() != SCENARIO_TYPE) return false;

    this.reportResult = onTestDone;
    this.reportEnd = onAllTestsComplete;
    this.runScenario();

    return true;
  };

  this.getTestRunsConfigurationFor = function(testCaseInfos, expressions, testRunsConfiguration) {
    testRunsConfiguration.push(
        new jstestdriver.TestRunConfiguration(
            new jstestdriver.TestCaseInfo(
                'Angular Scenario Tests', function() {}, SCENARIO_TYPE), []));

    return true;
  };
}

/**
 * Singleton instance of the plugin
 * Accessed using closure by:
 *  - jstd output (reports to this plugin)
 *  - initScenarioAdapter (register the plugin to jstd)
 */
var plugin = new JstdPlugin();

/**
 * Initialise scenario jstd-adapter
 * (only if jstestdriver is defined)
 *
 * @param {Object} jstestdriver Undefined when run from browser (without jstd)
 * @param {Function} initScenarioAndRun Function that inits scenario and runs all the tests
 * @param {Object=} config Configuration object, supported properties:
 *  - relativeUrlPrefix: prefix for all relative links when navigateTo()
 */
function initScenarioAdapter(jstestdriver, initScenarioAndRun, config) {
  if (jstestdriver) {
    // create and register ScenarioPlugin
    jstestdriver.pluginRegistrar.register(plugin);
    plugin.runScenario = initScenarioAndRun;

    /**
     * HACK (angular.scenario.Application.navigateTo)
     *
     * We need to navigate to relative urls when running from browser (without JSTD),
     * because we want to allow running scenario tests without creating its own virtual host.
     * For example: http://angular.local/build/docs/docs-scenario.html
     *
     * On the other hand, when running with JSTD, we need to navigate to absolute urls,
     * because of JSTD proxy. (proxy, because of same domain policy)
     *
     * So this hack is applied only if running with JSTD and change all relative urls to absolute.
     */
    var appProto = angular.scenario.Application.prototype,
        navigateTo = appProto.navigateTo,
        relativeUrlPrefix = config && config.relativeUrlPrefix || '/';

    appProto.navigateTo = function(url, loadFn, errorFn) {
      if (url.charAt(0) != '/' && url.charAt(0) != '#' &&
          url != 'about:blank' && !url.match(/^https?/)) {
        url = relativeUrlPrefix + url;
      }

      return navigateTo.call(this, url, loadFn, errorFn);
    };
  }
}

/**
 * Builds proper TestResult object from given model spec
 *
 * TODO(vojta) report error details
 *
 * @param {angular.scenario.ObjectModel.Spec} spec
 * @returns {jstestdriver.TestResult}
 */
function createTestResultFromSpec(spec) {
  var map = {
    success: 'PASSED',
    error:   'ERROR',
    failure: 'FAILED'
  };

  return new jstestdriver.TestResult(
    spec.fullDefinitionName,
    spec.name,
    jstestdriver.TestResult.RESULT[map[spec.status]],
    spec.error || '',
    spec.line || '',
    spec.duration);
}

/**
 * Generates JSTD output (jstestdriver.TestResult)
 */
angular.scenario.output('jstd', function(context, runner, model) {
  model.on('SpecEnd', function(spec) {
    plugin.reportResult(createTestResultFromSpec(spec));
  });

  model.on('RunnerEnd', function() {
    plugin.reportEnd();
  });
});
initScenarioAdapter(window.jstestdriver, angular.scenario.setUpAndRun, window.jstdScenarioAdapter);
})(window);