/* * Copyright 2004 ThoughtWorks, Inc * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ // An object representing the current test, used external var currentTest = null; // TODO: get rid of this global, which mirrors the htmlTestRunner.currentTest var selenium = null; var htmlTestRunner; var HtmlTestRunner = classCreate(); objectExtend(HtmlTestRunner.prototype, { initialize: function() { this.metrics = new Metrics(); this.controlPanel = new HtmlTestRunnerControlPanel(); this.testFailed = false; this.currentTest = null; this.runAllTests = false; this.appWindow = null; // we use a timeout here to make sure the LOG has loaded first, so we can see _every_ error setTimeout(fnBind(function() { this.loadSuiteFrame(); }, this), 500); }, getTestSuite: function() { return suiteFrame.getCurrentTestSuite(); }, markFailed: function() { this.testFailed = true; this.getTestSuite().markFailed(); }, loadSuiteFrame: function() { if (selenium == null) { var appWindow = this._getApplicationWindow(); try { appWindow.location; } catch (e) { // when reloading, we may be pointing at an old window (Perm Denied) setTimeout(fnBind(function() { this.loadSuiteFrame(); }, this), 50); return; } selenium = Selenium.createForWindow(appWindow); this._registerCommandHandlers(); } this.controlPanel.setHighlightOption(); var testSuiteName = this.controlPanel.getTestSuiteName(); var self = this; if (testSuiteName) { suiteFrame.load(testSuiteName, function() {setTimeout(fnBind(self._onloadTestSuite, self), 50)} ); selenium.browserbot.baseUrl = absolutify(testSuiteName, window.location.href); } // DGF or should we use the old default? // selenium.browserbot.baseUrl = window.location.href; if (this.controlPanel.getBaseUrl()) { selenium.browserbot.baseUrl = this.controlPanel.getBaseUrl(); } }, _getApplicationWindow: function () { if (this.controlPanel.isMultiWindowMode()) { return this._getSeparateApplicationWindow(); } return $('myiframe').contentWindow; }, _getSeparateApplicationWindow: function () { if (this.appWindow == null) { this.appWindow = openSeparateApplicationWindow('TestRunner-splash.html', this.controlPanel.isAutomatedRun()); } return this.appWindow; }, _onloadTestSuite:function () { if (! this.getTestSuite().isAvailable()) { return; } if (this.controlPanel.isAutomatedRun()) { this.startTestSuite(); } else if (this.controlPanel.getAutoUrl()) { //todo what is the autourl doing, left to check it out addLoadListener(this._getApplicationWindow(), fnBind(this._startSingleTest, this)); this._getApplicationWindow().src = this.controlPanel.getAutoUrl(); } else { this.getTestSuite().getSuiteRows()[0].loadTestCase(); } }, _startSingleTest:function () { removeLoadListener(getApplicationWindow(), fnBind(this._startSingleTest, this)); var singleTestName = this.controlPanel.getSingleTestName(); testFrame.load(singleTestName, fnBind(this.startTest, this)); }, _registerCommandHandlers: function () { this.commandFactory = new CommandHandlerFactory(); this.commandFactory.registerAll(selenium); }, startTestSuite: function() { this.controlPanel.reset(); this.metrics.resetMetrics(); this.getTestSuite().reset(); this.runAllTests = true; this.runNextTest(); }, runNextTest: function () { this.getTestSuite().updateSuiteWithResultOfPreviousTest(); if (!this.runAllTests) { return; } this.getTestSuite().runNextTestInSuite(); }, startTest: function () { this.controlPanel.reset(); testFrame.scrollToTop(); //todo: move testFailed and storedVars to TestCase this.testFailed = false; storedVars = new Object(); this.currentTest = new HtmlRunnerTestLoop(testFrame.getCurrentTestCase(), this.metrics, this.commandFactory); currentTest = this.currentTest; this.currentTest.start(); }, runSingleTest:function() { this.runAllTests = false; this.metrics.resetMetrics(); this.startTest(); } }); var runInterval = 0; /** SeleniumFrame encapsulates an iframe element */ var SeleniumFrame = classCreate(); objectExtend(SeleniumFrame.prototype, { initialize : function(frame) { this.frame = frame; addLoadListener(this.frame, fnBind(this._handleLoad, this)); }, getDocument : function() { return this.frame.contentWindow.document; }, _handleLoad: function() { this._attachStylesheet(); this._onLoad(); if (this.loadCallback) { this.loadCallback(); this.loadCallback = null; } }, _attachStylesheet: function() { var d = this.getDocument(); var head = d.getElementsByTagName('head').item(0); var styleLink = d.createElement("link"); styleLink.rel = "stylesheet"; styleLink.type = "text/css"; if (browserVersion && browserVersion.isChrome) { // DGF We have to play a clever trick to get the right absolute path. // This trick works on most browsers, (not IE), but is only needed in // chrome var tempLink = window.document.createElement("link"); tempLink.href = "selenium-test.css"; // this will become an absolute href styleLink.href = tempLink.href; } else { // this works in every browser (except Firefox in chrome mode) var styleSheetPath = window.location.pathname.replace(/[^\/\\]+$/, "selenium-test.css"); if (browserVersion.isIE && window.location.protocol == "file:") { styleSheetPath = "file://" + styleSheetPath; } styleLink.href = styleSheetPath; } head.appendChild(styleLink); }, _onLoad: function() { }, scrollToTop : function() { this.frame.contentWindow.scrollTo(0, 0); }, _setLocation: function(location) { var isChrome = browserVersion.isChrome || false; var isHTA = browserVersion.isHTA || false; // DGF TODO multiWindow location += "?thisIsChrome=" + isChrome + "&thisIsHTA=" + isHTA; if (browserVersion.isSafari) { // safari doesn't reload the page when the location equals to current location. // hence, set the location to blank so that the page will reload automatically. this.frame.src = "about:blank"; this.frame.src = location; } else { this.frame.contentWindow.location.replace(location); } }, load: function(/* url, [callback] */) { if (arguments.length > 1) { this.loadCallback = arguments[1]; } this._setLocation(arguments[0]); } }); /** HtmlTestSuiteFrame - encapsulates the suite iframe element */ var HtmlTestSuiteFrame = classCreate(); objectExtend(HtmlTestSuiteFrame.prototype, SeleniumFrame.prototype); objectExtend(HtmlTestSuiteFrame.prototype, { getCurrentTestSuite: function() { if (!this.currentTestSuite) { this.currentTestSuite = new HtmlTestSuite(this.getDocument()); } return this.currentTestSuite; } }); /** HtmlTestFrame - encapsulates the test-case iframe element */ var HtmlTestFrame = classCreate(); objectExtend(HtmlTestFrame.prototype, SeleniumFrame.prototype); objectExtend(HtmlTestFrame.prototype, { _onLoad: function() { this.currentTestCase = new HtmlTestCase(this.getDocument(), htmlTestRunner.getTestSuite().getCurrentRow()); }, getCurrentTestCase: function() { return this.currentTestCase; } }); function onSeleniumLoad() { suiteFrame = new HtmlTestSuiteFrame(getSuiteFrame()); testFrame = new HtmlTestFrame(getTestFrame()); htmlTestRunner = new HtmlTestRunner(); } var suiteFrame; var testFrame; function getSuiteFrame() { var f = $('testSuiteFrame'); if (f == null) { f = top; // proxyInjection mode does not set myiframe } return f; } function getTestFrame() { var f = $('testFrame'); if (f == null) { f = top; // proxyInjection mode does not set myiframe } return f; } var HtmlTestRunnerControlPanel = classCreate(); objectExtend(HtmlTestRunnerControlPanel.prototype, URLConfiguration.prototype); objectExtend(HtmlTestRunnerControlPanel.prototype, { initialize: function() { this._acquireQueryString(); this.runInterval = 0; this.highlightOption = $('highlightOption'); this.pauseButton = $('pauseTest'); this.stepButton = $('stepTest'); this.highlightOption.onclick = fnBindAsEventListener((function() { this.setHighlightOption(); }), this); this.pauseButton.onclick = fnBindAsEventListener(this.pauseCurrentTest, this); this.stepButton.onclick = fnBindAsEventListener(this.stepCurrentTest, this); this.speedController = new Control.Slider('speedHandle', 'speedTrack', { range: $R(0, 1000), onSlide: fnBindAsEventListener(this.setRunInterval, this), onChange: fnBindAsEventListener(this.setRunInterval, this) }); this._parseQueryParameter(); }, setHighlightOption: function () { var isHighlight = this.highlightOption.checked; selenium.browserbot.setShouldHighlightElement(isHighlight); }, _parseQueryParameter: function() { var tempRunInterval = this._getQueryParameter("runInterval"); if (tempRunInterval) { this.setRunInterval(tempRunInterval); } this.highlightOption.checked = this._getQueryParameter("highlight"); }, setRunInterval: function(runInterval) { this.runInterval = runInterval; }, setToPauseAtNextCommand: function() { this.runInterval = -1; }, pauseCurrentTest: function () { this.setToPauseAtNextCommand(); this._switchPauseButtonToContinue(); }, continueCurrentTest: function () { this.reset(); currentTest.resume(); }, reset: function() { // this.runInterval = this.speedController.value; this._switchContinueButtonToPause(); }, _switchContinueButtonToPause: function() { this.pauseButton.className = "cssPauseTest"; this.pauseButton.onclick = fnBindAsEventListener(this.pauseCurrentTest, this); }, _switchPauseButtonToContinue: function() { $('stepTest').disabled = false; this.pauseButton.className = "cssContinueTest"; this.pauseButton.onclick = fnBindAsEventListener(this.continueCurrentTest, this); }, stepCurrentTest: function () { this.setToPauseAtNextCommand(); currentTest.resume(); }, isAutomatedRun: function() { return this._isQueryParameterTrue("auto"); }, shouldSaveResultsToFile: function() { return this._isQueryParameterTrue("save"); }, closeAfterTests: function() { return this._isQueryParameterTrue("close"); }, getTestSuiteName: function() { return this._getQueryParameter("test"); }, getSingleTestName: function() { return this._getQueryParameter("singletest"); }, getAutoUrl: function() { return this._getQueryParameter("autoURL"); }, getResultsUrl: function() { return this._getQueryParameter("resultsUrl"); }, _acquireQueryString: function() { if (this.queryString) return; if (browserVersion.isHTA) { var args = this._extractArgs(); if (args.length < 2) return null; this.queryString = args[1]; } else { this.queryString = location.search.substr(1); } } }); var AbstractResultAwareRow = classCreate(); objectExtend(AbstractResultAwareRow.prototype, { initialize: function(trElement) { this.trElement = trElement; }, setStatus: function(status) { this.unselect(); this.trElement.className = this.trElement.className.replace(/status_[a-z]+/, ""); if (status) { addClassName(this.trElement, "status_" + status); } }, select: function() { addClassName(this.trElement, "selected"); safeScrollIntoView(this.trElement); }, unselect: function() { removeClassName(this.trElement, "selected"); }, markPassed: function() { this.setStatus("passed"); }, markDone: function() { this.setStatus("done"); }, markFailed: function() { this.setStatus("failed"); } }); var TitleRow = classCreate(); objectExtend(TitleRow.prototype, AbstractResultAwareRow.prototype); objectExtend(TitleRow.prototype, { initialize: function(trElement) { this.trElement = trElement; trElement.className = "title"; } }); var HtmlTestCaseRow = classCreate(); objectExtend(HtmlTestCaseRow.prototype, AbstractResultAwareRow.prototype); objectExtend(HtmlTestCaseRow.prototype, { getCommand: function () { return new SeleniumCommand(getText(this.trElement.cells[0]), getText(this.trElement.cells[1]), getText(this.trElement.cells[2]), this.isBreakpoint()); }, markFailed: function(errorMsg) { AbstractResultAwareRow.prototype.markFailed.call(this, errorMsg); this.setMessage(errorMsg); }, setMessage: function(message) { setText(this.trElement.cells[2], message); }, reset: function() { this.setStatus(null); var thirdCell = this.trElement.cells[2]; if (thirdCell) { if (thirdCell.originalHTML) { thirdCell.innerHTML = thirdCell.originalHTML; } else { thirdCell.originalHTML = thirdCell.innerHTML; } } }, onClick: function() { if (this.trElement.isBreakpoint == undefined) { this.trElement.isBreakpoint = true; addClassName(this.trElement, "breakpoint"); } else { this.trElement.isBreakpoint = undefined; removeClassName(this.trElement, "breakpoint"); } }, addBreakpointSupport: function() { elementSetStyle(this.trElement, {"cursor" : "pointer"}); this.trElement.onclick = fnBindAsEventListener(function() { this.onClick(); }, this); }, isBreakpoint: function() { if (this.trElement.isBreakpoint == undefined || this.trElement.isBreakpoint == null) { return false } return this.trElement.isBreakpoint; } }); var HtmlTestSuiteRow = classCreate(); objectExtend(HtmlTestSuiteRow.prototype, AbstractResultAwareRow.prototype); objectExtend(HtmlTestSuiteRow.prototype, { initialize: function(trElement, testFrame, htmlTestSuite) { this.trElement = trElement; this.testFrame = testFrame; this.htmlTestSuite = htmlTestSuite; this.link = trElement.getElementsByTagName("a")[0]; this.link.onclick = fnBindAsEventListener(this._onClick, this); }, reset: function() { this.setStatus(null); }, _onClick: function() { this.loadTestCase(null); return false; }, loadTestCase: function(onloadFunction) { this.htmlTestSuite.unselectCurrentRow(); this.select(); this.htmlTestSuite.currentRowInSuite = this.trElement.rowIndex - 1; // If the row has a stored results table, use that var resultsFromPreviousRun = this.trElement.cells[1]; if (resultsFromPreviousRun) { // todo: delegate to TestFrame, e.g. // this.testFrame.restoreTestCase(resultsFromPreviousRun.innerHTML); var testBody = this.testFrame.getDocument().body; testBody.innerHTML = resultsFromPreviousRun.innerHTML; this.testFrame._onLoad(); if (onloadFunction) { onloadFunction(); } } else { this.testFrame.load(this.link.href, onloadFunction); } }, saveTestResults: function() { // todo: GLOBAL ACCESS! var resultHTML = this.testFrame.getDocument().body.innerHTML; if (!resultHTML) return; // todo: why create this div? var divElement = this.trElement.ownerDocument.createElement("div"); divElement.innerHTML = resultHTML; var hiddenCell = this.trElement.ownerDocument.createElement("td"); hiddenCell.appendChild(divElement); hiddenCell.style.display = "none"; this.trElement.appendChild(hiddenCell); } }); var HtmlTestSuite = classCreate(); objectExtend(HtmlTestSuite.prototype, { initialize: function(suiteDocument) { this.suiteDocument = suiteDocument; this.suiteRows = this._collectSuiteRows(); this.titleRow = new TitleRow(this.getTestTable().rows[0]); this.reset(); }, reset: function() { this.failed = false; this.currentRowInSuite = -1; this.titleRow.setStatus(null); for (var i = 0; i < this.suiteRows.length; i++) { var row = this.suiteRows[i]; row.reset(); } }, getSuiteRows: function() { return this.suiteRows; }, getTestTable: function() { var tables = $A(this.suiteDocument.getElementsByTagName("table")); return tables[0]; }, isAvailable: function() { return this.getTestTable() != null; }, _collectSuiteRows: function () { var result = []; var tables = $A(this.suiteDocument.getElementsByTagName("table")); var testTable = tables[0]; for (rowNum = 1; rowNum < testTable.rows.length; rowNum++) { var rowElement = testTable.rows[rowNum]; result.push(new HtmlTestSuiteRow(rowElement, testFrame, this)); } // process the unsuited rows as well for (var tableNum = 1; tableNum < $A(this.suiteDocument.getElementsByTagName("table")).length; tableNum++) { testTable = tables[tableNum]; for (rowNum = 1; rowNum < testTable.rows.length; rowNum++) { var rowElement = testTable.rows[rowNum]; new HtmlTestSuiteRow(rowElement, testFrame, this); } } return result; }, getCurrentRow: function() { if (this.currentRowInSuite == -1) { return null; } return this.suiteRows[this.currentRowInSuite]; }, unselectCurrentRow: function() { var currentRow = this.getCurrentRow() if (currentRow) { currentRow.unselect(); } }, markFailed: function() { this.failed = true; this.titleRow.markFailed(); }, markDone: function() { if (!this.failed) { this.titleRow.markPassed(); } }, _startCurrentTestCase: function() { this.getCurrentRow().loadTestCase(fnBind(htmlTestRunner.startTest, htmlTestRunner)); }, _onTestSuiteComplete: function() { this.markDone(); new TestResult(this.failed, this.getTestTable()).post(); }, updateSuiteWithResultOfPreviousTest: function() { if (this.currentRowInSuite >= 0) { this.getCurrentRow().saveTestResults(); } }, runNextTestInSuite: function() { this.currentRowInSuite++; // If we are done with all of the tests, set the title bar as pass or fail if (this.currentRowInSuite >= this.suiteRows.length) { this._onTestSuiteComplete(); } else { this._startCurrentTestCase(); } } }); var TestResult = classCreate(); objectExtend(TestResult.prototype, { // Post the results to a servlet, CGI-script, etc. The URL of the // results-handler defaults to "/postResults", but an alternative location // can be specified by providing a "resultsUrl" query parameter. // // Parameters passed to the results-handler are: // result: passed/failed depending on whether the suite passed or failed // totalTime: the total running time in seconds for the suite. // // numTestPasses: the total number of tests which passed. // numTestFailures: the total number of tests which failed. // // numCommandPasses: the total number of commands which passed. // numCommandFailures: the total number of commands which failed. // numCommandErrors: the total number of commands which errored. // // suite: the suite table, including the hidden column of test results // testTable.1 to testTable.N: the individual test tables // initialize: function (suiteFailed, suiteTable) { this.controlPanel = htmlTestRunner.controlPanel; this.metrics = htmlTestRunner.metrics; this.suiteFailed = suiteFailed; this.suiteTable = suiteTable; }, post: function () { if (!this.controlPanel.isAutomatedRun()) { return; } var form = document.createElement("form"); document.body.appendChild(form); form.id = "resultsForm"; form.method = "post"; form.target = "myiframe"; var resultsUrl = this.controlPanel.getResultsUrl(); if (!resultsUrl) { resultsUrl = "./postResults"; } var actionAndParameters = resultsUrl.split('?', 2); form.action = actionAndParameters[0]; var resultsUrlQueryString = actionAndParameters[1]; form.createHiddenField = function(name, value) { input = document.createElement("input"); input.type = "hidden"; input.name = name; input.value = value; this.appendChild(input); }; if (resultsUrlQueryString) { var clauses = resultsUrlQueryString.split('&'); for (var i = 0; i < clauses.length; i++) { var keyValuePair = clauses[i].split('=', 2); var key = unescape(keyValuePair[0]); var value = unescape(keyValuePair[1]); form.createHiddenField(key, value); } } form.createHiddenField("selenium.version", Selenium.version); form.createHiddenField("selenium.revision", Selenium.revision); form.createHiddenField("result", this.suiteFailed ? "failed" : "passed"); form.createHiddenField("totalTime", Math.floor((this.metrics.currentTime - this.metrics.startTime) / 1000)); form.createHiddenField("numTestPasses", this.metrics.numTestPasses); form.createHiddenField("numTestFailures", this.metrics.numTestFailures); form.createHiddenField("numCommandPasses", this.metrics.numCommandPasses); form.createHiddenField("numCommandFailures", this.metrics.numCommandFailures); form.createHiddenField("numCommandErrors", this.metrics.numCommandErrors); // Create an input for each test table. The inputs are named // testTable.1, testTable.2, etc. for (rowNum = 1; rowNum < this.suiteTable.rows.length; rowNum++) { // If there is a second column, then add a new input if (this.suiteTable.rows[rowNum].cells.length > 1) { var resultCell = this.suiteTable.rows[rowNum].cells[1]; form.createHiddenField("testTable." + rowNum, resultCell.innerHTML); // remove the resultCell, so it's not included in the suite HTML resultCell.parentNode.removeChild(resultCell); } } form.createHiddenField("numTestTotal", rowNum); // Add HTML for the suite itself form.createHiddenField("suite", this.suiteTable.parentNode.innerHTML); if (this.controlPanel.shouldSaveResultsToFile()) { this._saveToFile(resultsUrl, form); } else { form.submit(); } document.body.removeChild(form); if (this.controlPanel.closeAfterTests()) { window.top.close(); } }, _saveToFile: function (fileName, form) { // This only works when run as an IE HTA var inputs = new Object(); for (var i = 0; i < form.elements.length; i++) { inputs[form.elements[i].name] = form.elements[i].value; } var objFSO = new ActiveXObject("Scripting.FileSystemObject") var scriptFile = objFSO.CreateTextFile(fileName); scriptFile.WriteLine("
\nresult: | \n" + inputs["result"] + " | \n" + "
totalTime: | \n" + inputs["totalTime"] + " | \n
numTestPasses: | \n" + inputs["numTestPasses"] + " | \n
numTestFailures: | \n" + inputs["numTestFailures"] + " | \n
numCommandPasses: | \n" + inputs["numCommandPasses"] + " | \n
numCommandFailures: | \n" + inputs["numCommandFailures"] + " | \n
numCommandErrors: | \n" + inputs["numCommandErrors"] + " | \n
" + inputs["suite"] + " | \n\n |
" + inputs["testTable." + rowNum] + " | \n\n |
See the select command for more information about option locators.
* * @param selectLocator an element locator identifying a drop-down menu * @param optionLocator an option locator, typically just an option label (e.g. "John Smith") */ var element = this.page().findElement(selectLocator); var locator = this.optionLocatorFactory.fromLocatorString(optionLocator); if (element.selectedIndex == -1) { Assert.fail("No option selected"); } locator.assertSelected(element); }; Selenium.prototype.assertFailureOnNext = function(message) { /** * Tell Selenium to expect a failure on the next command execution. * @param message The failure message we should expect. This command will fail if the wrong failure message appears. */ if (!message) { throw new SeleniumError("Message must be provided"); } currentTest.expectedFailure = message; currentTest.expectedFailureType = "failure"; currentTest.expectedFailureJustSet = true; }; Selenium.prototype.assertErrorOnNext = function(message) { /** * Tell Selenium to expect an error on the next command execution. * @param message The error message we should expect. This command will fail if the wrong error message appears. */ // This command temporarily installs a CommandFactory that generates // CommandHandlers that expect an error. if (!message) { throw new SeleniumError("Message must be provided"); } currentTest.expectedFailure = message; currentTest.expectedFailureType = "error"; currentTest.expectedFailureJustSet = true; };