diff options
Diffstat (limited to 'tests/FunctionalTests/selenium/core/scripts/selenium-browserbot.js')
| -rwxr-xr-x | tests/FunctionalTests/selenium/core/scripts/selenium-browserbot.js | 1114 |
1 files changed, 1114 insertions, 0 deletions
diff --git a/tests/FunctionalTests/selenium/core/scripts/selenium-browserbot.js b/tests/FunctionalTests/selenium/core/scripts/selenium-browserbot.js new file mode 100755 index 00000000..8df46865 --- /dev/null +++ b/tests/FunctionalTests/selenium/core/scripts/selenium-browserbot.js @@ -0,0 +1,1114 @@ +/* +* 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. +* +*/ + +/* +* This script provides the Javascript API to drive the test application contained within +* a Browser Window. +* TODO: +* Add support for more events (keyboard and mouse) +* Allow to switch "user-entry" mode from mouse-based to keyboard-based, firing different +* events in different modes. +*/ + +// The window to which the commands will be sent. For example, to click on a +// popup window, first select that window, and then do a normal click command. + +var BrowserBot = function(frame) { + this.frame = frame; + this.currentPage = null; + this.currentWindowName = null; + + this.modalDialogTest = null; + this.recordedAlerts = new Array(); + this.recordedConfirmations = new Array(); + this.recordedPrompts = new Array(); + this.openedWindows = {}; + this.nextConfirmResult = true; + this.nextPromptResult = ''; + this.newPageLoaded = false; + this.pageLoadError = null; + + var self = this; + this.recordPageLoad = function() { + LOG.debug("Page load detected"); + try { + LOG.debug("Page load location=" + self.getCurrentWindow().location); + } catch (e) { + self.pageLoadError = e; + return; + } + self.currentPage = null; + self.newPageLoaded = true; + }; + + this.isNewPageLoaded = function() { + if (this.pageLoadError) throw this.pageLoadError; + return self.newPageLoaded; + }; +}; + +BrowserBot.createForFrame = function(frame) { + var browserbot; + LOG.debug("browserName: " + browserVersion.name); + LOG.debug("userAgent: " + navigator.userAgent); + if (browserVersion.isIE) { + browserbot = new IEBrowserBot(frame); + } + else if (browserVersion.isKonqueror) { + browserbot = new KonquerorBrowserBot(frame); + } + else if (browserVersion.isSafari) { + browserbot = new SafariBrowserBot(frame); + } + else { + LOG.info("Using MozillaBrowserBot") + // Use mozilla by default + browserbot = new MozillaBrowserBot(frame); + } + + // Modify the test IFrame so that page loads are detected. + addLoadListener(browserbot.getFrame(), browserbot.recordPageLoad); + return browserbot; +}; + +BrowserBot.prototype.doModalDialogTest = function(test) { + this.modalDialogTest = test; +}; + +BrowserBot.prototype.cancelNextConfirmation = function() { + this.nextConfirmResult = false; +}; + +BrowserBot.prototype.setNextPromptResult = function(result) { + this.nextPromptResult = result; +}; + +BrowserBot.prototype.hasAlerts = function() { + return (this.recordedAlerts.length > 0) ; +}; + +BrowserBot.prototype.getNextAlert = function() { + return this.recordedAlerts.shift(); +}; + +BrowserBot.prototype.hasConfirmations = function() { + return (this.recordedConfirmations.length > 0) ; +}; + +BrowserBot.prototype.getNextConfirmation = function() { + return this.recordedConfirmations.shift(); +}; + +BrowserBot.prototype.hasPrompts = function() { + return (this.recordedPrompts.length > 0) ; +}; + +BrowserBot.prototype.getNextPrompt = function() { + return this.recordedPrompts.shift(); +}; + +BrowserBot.prototype.getFrame = function() { + return this.frame; +}; + +BrowserBot.prototype.selectWindow = function(target) { + // we've moved to a new page - clear the current one + this.currentPage = null; + this.currentWindowName = null; + if (target && target != "null") { + // If window exists + if (this.getTargetWindow(target)) { + this.currentWindowName = target; + } + } +}; + +BrowserBot.prototype.openLocation = function(target) { + // We're moving to a new page - clear the current one + this.currentPage = null; + this.newPageLoaded = false; + + this.setOpenLocation(target); +}; + +BrowserBot.prototype.setIFrameLocation = function(iframe, location) { + iframe.src = location; +}; + +BrowserBot.prototype.setOpenLocation = function(location) { + this.getCurrentWindow().location.href = location; +}; + +BrowserBot.prototype.getCurrentPage = function() { + if (this.currentPage == null) { + var testWindow = this.getCurrentWindow(); + this.modifyWindowToRecordPopUpDialogs(testWindow, this); + this.modifySeparateTestWindowToDetectPageLoads(testWindow); + this.currentPage = PageBot.createForWindow(testWindow); + this.newPageLoaded = false; + } + + return this.currentPage; +}; + +BrowserBot.prototype.modifyWindowToRecordPopUpDialogs = function(windowToModify, browserBot) { + windowToModify.alert = function(alert) { + browserBot.recordedAlerts.push(alert); + }; + + windowToModify.confirm = function(message) { + browserBot.recordedConfirmations.push(message); + var result = browserBot.nextConfirmResult; + browserBot.nextConfirmResult = true; + return result; + }; + + windowToModify.prompt = function(message) { + browserBot.recordedPrompts.push(message); + var result = !browserBot.nextConfirmResult ? null : browserBot.nextPromptResult; + browserBot.nextConfirmResult = true; + browserBot.nextPromptResult = ''; + return result; + }; + + // Keep a reference to all popup windows by name + // note that in IE the "windowName" argument must be a valid javascript identifier, it seems. + var originalOpen = windowToModify.open; + windowToModify.open = function(url, windowName, windowFeatures, replaceFlag) { + var openedWindow = originalOpen(url, windowName, windowFeatures, replaceFlag); + selenium.browserbot.openedWindows[windowName] = openedWindow; + return openedWindow; + }; +}; + +/** + * The main IFrame has a single, long-lived onload handler that clears + * Browserbot.currentPage and sets the "newPageLoaded" flag. For separate + * windows, we need to attach a handler each time. This uses the + * "callOnWindowPageTransition" mechanism, which is implemented differently + * for different browsers. + */ +BrowserBot.prototype.modifySeparateTestWindowToDetectPageLoads = function(windowToModify) { + if (this.currentWindowName != null) { + this.callOnWindowPageTransition(this.recordPageLoad, windowToModify); + } +}; + +/** + * Call the supplied function when a the current page unloads and a new one loads. + * This is done by polling continuously until the document changes and is fully loaded. + */ +BrowserBot.prototype.callOnWindowPageTransition = function(loadFunction, windowObject) { + // Since the unload event doesn't fire in Safari 1.3, we start polling immediately + if (windowObject && !windowObject.closed) { + LOG.debug("Starting pollForLoad: " + windowObject.document.location); + this.pollingForLoad = true; + this.pollForLoad(loadFunction, windowObject, windowObject.location, windowObject.location.href); + } +}; + +/** + * Set up a polling timer that will keep checking the readyState of the document until it's complete. + * Since we might call this before the original page is unloaded, we first check to see that the current location + * or href is different from the original one. + */ +BrowserBot.prototype.pollForLoad = function(loadFunction, windowObject, originalLocation, originalHref) { + var windowClosed = true; + try { + windowClosed = windowObject.closed; + } catch (e) { + LOG.debug("exception detecting closed window (I guess it must be closed)"); + LOG.exception(e); + // swallow exceptions which may occur in HTA mode when the window is closed + } + if (null == windowClosed) windowClosed = true; + if (windowClosed) { + this.pollingForLoad = false; + return; + } + + LOG.debug("pollForLoad original: " + originalHref); + try { + + var currentLocation = windowObject.location; + var currentHref = currentLocation.href + + var sameLoc = (originalLocation === currentLocation); + var sameHref = (originalHref === currentHref); + var rs = windowObject.document.readyState; + + if (rs == null) rs = 'complete'; + + if (!(sameLoc && sameHref) && rs == 'complete') { + LOG.debug("pollForLoad complete: " + rs + " (" + currentHref + ")"); + loadFunction(); + this.pollingForLoad = false; + return; + } + var self = this; + LOG.debug("pollForLoad continue: " + currentHref); + window.setTimeout(function() {self.pollForLoad(loadFunction, windowObject, originalLocation, originalHref);}, 500); + } catch (e) { + LOG.error("Exception during pollForLoad; this should get noticed soon!"); + LOG.exception(e); + this.pageLoadError = e; + } +}; + + +BrowserBot.prototype.getContentWindow = function() { + return this.getFrame().contentWindow || frames[this.getFrame().id]; +}; + +BrowserBot.prototype.getTargetWindow = function(windowName) { + LOG.debug("getTargetWindow(" + windowName + ")"); + // First look in the map of opened windows + var targetWindow = this.openedWindows[windowName]; + if (!targetWindow) { + var evalString = "this.getContentWindow().window." + windowName; + targetWindow = eval(evalString); + } + if (!targetWindow) { + throw new SeleniumError("Window does not exist"); + } + return targetWindow; +}; + +BrowserBot.prototype.getCurrentWindow = function() { + var testWindow = this.getContentWindow().window; + if (this.currentWindowName != null) { + testWindow = this.getTargetWindow(this.currentWindowName); + } + return testWindow; +}; + +function MozillaBrowserBot(frame) { + BrowserBot.call(this, frame); +} +MozillaBrowserBot.prototype = new BrowserBot; + +function KonquerorBrowserBot(frame) { + BrowserBot.call(this, frame); +} +KonquerorBrowserBot.prototype = new BrowserBot; + +KonquerorBrowserBot.prototype.setIFrameLocation = function(iframe, location) { + // Window doesn't fire onload event when setting src to the current value, + // so we set it to blank first. + iframe.src = "about:blank"; + iframe.src = location; +}; + +KonquerorBrowserBot.prototype.setOpenLocation = function(location) { + // Window doesn't fire onload event when setting src to the current value, + // so we set it to blank first. + this.getCurrentWindow().location.href = "about:blank"; + this.getCurrentWindow().location.href = location; +}; + +function SafariBrowserBot(frame) { + BrowserBot.call(this, frame); +} +SafariBrowserBot.prototype = new BrowserBot; + +SafariBrowserBot.prototype.setIFrameLocation = KonquerorBrowserBot.prototype.setIFrameLocation; + +function IEBrowserBot(frame) { + BrowserBot.call(this, frame); +} +IEBrowserBot.prototype = new BrowserBot; + +IEBrowserBot.prototype.modifyWindowToRecordPopUpDialogs = function(windowToModify, browserBot) { + BrowserBot.prototype.modifyWindowToRecordPopUpDialogs(windowToModify, browserBot); + + // we will call the previous version of this method from within our own interception + oldShowModalDialog = windowToModify.showModalDialog; + + windowToModify.showModalDialog = function(url, args, features) { + // Get relative directory to where TestRunner.html lives + // A risky assumption is that the user's TestRunner is named TestRunner.html + var doc_location = document.location.toString(); + var end_of_base_ref = doc_location.indexOf('TestRunner.html'); + var base_ref = doc_location.substring(0, end_of_base_ref); + + var fullURL = base_ref + "TestRunner.html?singletest=" + escape(browserBot.modalDialogTest) + "&autoURL=" + escape(url) + "&runInterval=" + runInterval; + browserBot.modalDialogTest = null; + + var returnValue = oldShowModalDialog(fullURL, args, features); + return returnValue; + }; +}; + +SafariBrowserBot.prototype.modifyWindowToRecordPopUpDialogs = function(windowToModify, browserBot) { + BrowserBot.prototype.modifyWindowToRecordPopUpDialogs(windowToModify, browserBot); + + var originalOpen = windowToModify.open; + /* + * Safari seems to be broken, so that when we manually trigger the onclick method + * of a button/href, any window.open calls aren't resolved relative to the app location. + * So here we replace the open() method with one that does resolve the url correctly. + */ + windowToModify.open = function(url, windowName, windowFeatures, replaceFlag) { + + if (url.startsWith("http://") || url.startsWith("https://") || url.startsWith("/")) { + return originalOpen(url, windowName, windowFeatures, replaceFlag); + } + + // Reduce the current path to the directory + var currentPath = windowToModify.location.pathname || "/"; + currentPath = currentPath.replace(/\/[^\/]*$/, "/"); + + // Remove any leading "./" from the new url. + url = url.replace(/^\.\//, ""); + + newUrl = currentPath + url; + + return originalOpen(newUrl, windowName, windowFeatures, replaceFlag); + }; +}; + +var PageBot = function(pageWindow) { + if (pageWindow) { + this.currentWindow = pageWindow; + this.currentDocument = pageWindow.document; + this.location = pageWindow.location; + this.title = function() {return this.currentDocument.title;}; + } + + // Register all locateElementBy* functions + // TODO - don't do this in the constructor - only needed once ever + this.locationStrategies = {}; + for (var functionName in this) { + var result = /^locateElementBy([A-Z].+)$/.exec(functionName); + if (result != null) { + var locatorFunction = this[functionName]; + if (typeof(locatorFunction) != 'function') { + continue; + } + // Use a specified prefix in preference to one generated from + // the function name + var locatorPrefix = locatorFunction.prefix || result[1].toLowerCase(); + this.locationStrategies[locatorPrefix] = locatorFunction; + } + } + + /** + * Find a locator based on a prefix. + */ + this.findElementBy = function(locatorType, locator, inDocument) { + var locatorFunction = this.locationStrategies[locatorType]; + if (! locatorFunction) { + throw new SeleniumError("Unrecognised locator type: '" + locatorType + "'"); + } + return locatorFunction.call(this, locator, inDocument); + }; + + /** + * The implicit locator, that is used when no prefix is supplied. + */ + this.locationStrategies['implicit'] = function(locator, inDocument) { + if (locator.startsWith('//')) { + return this.locateElementByXPath(locator, inDocument); + } + if (locator.startsWith('document.')) { + return this.locateElementByDomTraversal(locator, inDocument); + } + return this.locateElementByIdentifier(locator, inDocument); + }; + +}; + +PageBot.createForWindow = function(windowObject) { + if (browserVersion.isIE) { + return new IEPageBot(windowObject); + } + else if (browserVersion.isKonqueror) { + return new KonquerorPageBot(windowObject); + } + else if (browserVersion.isSafari) { + return new SafariPageBot(windowObject); + } + else if (browserVersion.isOpera) { + return new OperaPageBot(windowObject); + } + else { + LOG.info("Using MozillaPageBot") + // Use mozilla by default + return new MozillaPageBot(windowObject); + } +}; + +var MozillaPageBot = function(pageWindow) { + PageBot.call(this, pageWindow); +}; +MozillaPageBot.prototype = new PageBot(); + +var KonquerorPageBot = function(pageWindow) { + PageBot.call(this, pageWindow); +}; +KonquerorPageBot.prototype = new PageBot(); + +var SafariPageBot = function(pageWindow) { + PageBot.call(this, pageWindow); +}; +SafariPageBot.prototype = new PageBot(); + +var IEPageBot = function(pageWindow) { + PageBot.call(this, pageWindow); +}; +IEPageBot.prototype = new PageBot(); + +OperaPageBot = function(pageWindow) { + PageBot.call(this, pageWindow); +}; +OperaPageBot.prototype = new PageBot(); + +/* +* Finds an element on the current page, using various lookup protocols +*/ +PageBot.prototype.findElement = function(locator) { + var locatorType = 'implicit'; + var locatorString = locator; + + // If there is a locator prefix, use the specified strategy + var result = locator.match(/^([A-Za-z]+)=(.+)/); + if (result) { + locatorType = result[1].toLowerCase(); + locatorString = result[2]; + } + + var element = this.findElementBy(locatorType, locatorString, this.currentDocument); + if (element != null) { + return element; + } + for (var i = 0; i < this.currentWindow.frames.length; i++) { + element = this.findElementBy(locatorType, locatorString, this.currentWindow.frames[i].document); + if (element != null) { + return element; + } + } + + // Element was not found by any locator function. + throw new SeleniumError("Element " + locator + " not found"); +}; + +/** + * In non-IE browsers, getElementById() does not search by name. Instead, we + * we search separately by id and name. + */ +PageBot.prototype.locateElementByIdentifier = function(identifier, inDocument) { + return PageBot.prototype.locateElementById(identifier, inDocument) + || PageBot.prototype.locateElementByName(identifier, inDocument) + || null; +}; + +/** + * In IE, getElementById() also searches by name - this is an optimisation for IE. + */ +IEPageBot.prototype.locateElementByIdentifer = function(identifier, inDocument) { + return inDocument.getElementById(identifier); +}; + +/** + * Find the element with id - can't rely on getElementById, coz it returns by name as well in IE.. + */ +PageBot.prototype.locateElementById = function(identifier, inDocument) { + var element = inDocument.getElementById(identifier); + if (element && element.id === identifier) { + return element; + } + else { + return null; + } +}; + +/** + * Find an element by name, refined by (optional) element-filter + * expressions. + */ +PageBot.prototype.locateElementByName = function(locator, document) { + var elements = document.getElementsByTagName("*"); + + var filters = locator.split(' '); + filters[0] = 'name=' + filters[0]; + + while (filters.length) { + var filter = filters.shift(); + elements = this.selectElements(filter, elements, 'value'); + } + + if (elements.length > 0) { + return elements[0]; + } + return null; +}; + +/** +* Finds an element using by evaluating the "document.*" string against the +* current document object. Dom expressions must begin with "document." +*/ +PageBot.prototype.locateElementByDomTraversal = function(domTraversal, inDocument) { + if (domTraversal.indexOf("document.") != 0) { + return null; + } + + // Trim the leading 'document' + domTraversal = domTraversal.substr(9); + var locatorScript = "inDocument." + domTraversal; + var element = eval(locatorScript); + + if (!element) { + return null; + } + + return element; +}; +PageBot.prototype.locateElementByDomTraversal.prefix = "dom"; + +/** +* Finds an element identified by the xpath expression. Expressions _must_ +* begin with "//". +*/ +PageBot.prototype.locateElementByXPath = function(xpath, inDocument) { + + // Trim any trailing "/": not valid xpath, and remains from attribute + // locator. + if (xpath.charAt(xpath.length - 1) == '/') { + xpath = xpath.slice(0, -1); + } + + // Handle //tag + var match = xpath.match(/^\/\/(\w+|\*)$/); + if (match) { + var elements = inDocument.getElementsByTagName(match[1].toUpperCase()); + if (elements == null) return null; + return elements[0]; + } + + // Handle //tag[@attr='value'] + var match = xpath.match(/^\/\/(\w+|\*)\[@(\w+)=('([^\']+)'|"([^\"]+)")\]$/); + if (match) { + return this.findElementByTagNameAndAttributeValue( + inDocument, + match[1].toUpperCase(), + match[2].toLowerCase(), + match[3].slice(1, -1) + ); + } + + // Handle //tag[text()='value'] + var match = xpath.match(/^\/\/(\w+|\*)\[text\(\)=('([^\']+)'|"([^\"]+)")\]$/); + if (match) { + return this.findElementByTagNameAndText( + inDocument, + match[1].toUpperCase(), + match[2].slice(1, -1) + ); + } + + return this.findElementUsingFullXPath(xpath, inDocument); +}; + +PageBot.prototype.findElementByTagNameAndAttributeValue = function( + inDocument, tagName, attributeName, attributeValue +) { + if (browserVersion.isIE && attributeName == "class") { + attributeName = "className"; + } + var elements = inDocument.getElementsByTagName(tagName); + for (var i = 0; i < elements.length; i++) { + var elementAttr = elements[i].getAttribute(attributeName); + if (elementAttr == attributeValue) { + return elements[i]; + } + } + return null; +}; + +PageBot.prototype.findElementByTagNameAndText = function( + inDocument, tagName, text +) { + var elements = inDocument.getElementsByTagName(tagName); + for (var i = 0; i < elements.length; i++) { + if (getText(elements[i]) == text) { + return elements[i]; + } + } + return null; +}; + +PageBot.prototype.findElementUsingFullXPath = function(xpath, inDocument) { + // Use document.evaluate() if it's available + if (inDocument.evaluate) { + return inDocument.evaluate(xpath, inDocument, null, 0, null).iterateNext(); + } + + // If not, fall back to slower JavaScript implementation + var context = new ExprContext(inDocument); + var xpathObj = xpathParse(xpath); + var xpathResult = xpathObj.evaluate(context); + if (xpathResult && xpathResult.value) { + return xpathResult.value[0]; + } + return null; +}; + +/** +* Finds a link element with text matching the expression supplied. Expressions must +* begin with "link:". +*/ +PageBot.prototype.locateElementByLinkText = function(linkText, inDocument) { + var links = inDocument.getElementsByTagName('a'); + for (var i = 0; i < links.length; i++) { + var element = links[i]; + if (PatternMatcher.matches(linkText, getText(element))) { + return element; + } + } + return null; +}; +PageBot.prototype.locateElementByLinkText.prefix = "link"; + +/** +* Returns an attribute based on an attribute locator. This is made up of an element locator +* suffixed with @attribute-name. +*/ +PageBot.prototype.findAttribute = function(locator) { + // Split into locator + attributeName + var attributePos = locator.lastIndexOf("@"); + var elementLocator = locator.slice(0, attributePos); + var attributeName = locator.slice(attributePos + 1); + + // Find the element. + var element = this.findElement(elementLocator); + + // Handle missing "class" attribute in IE. + if (browserVersion.isIE && attributeName == "class") { + attributeName = "className"; + } + + // Get the attribute value. + var attributeValue = element.getAttribute(attributeName); + + return attributeValue ? attributeValue.toString() : null; +}; + +/* +* Select the specified option and trigger the relevant events of the element. +*/ +PageBot.prototype.selectOption = function(element, optionToSelect) { + triggerEvent(element, 'focus', false); + var changed = false; + for (var i = 0; i < element.options.length; i++) { + var option = element.options[i]; + if (option.selected && option != optionToSelect) { + option.selected = false; + changed = true; + } + else if (!option.selected && option == optionToSelect) { + option.selected = true; + changed = true; + } + } + + if (changed) { + triggerEvent(element, 'change', true); + } + triggerEvent(element, 'blur', false); +}; + +/* +* Select the specified option and trigger the relevant events of the element. +*/ +PageBot.prototype.addSelection = function(element, option) { + this.checkMultiselect(element); + triggerEvent(element, 'focus', false); + if (!option.selected) { + option.selected = true; + triggerEvent(element, 'change', true); + } + triggerEvent(element, 'blur', false); +}; + +/* +* Select the specified option and trigger the relevant events of the element. +*/ +PageBot.prototype.removeSelection = function(element, option) { + this.checkMultiselect(element); + triggerEvent(element, 'focus', false); + if (option.selected) { + option.selected = false; + triggerEvent(element, 'change', true); + } + triggerEvent(element, 'blur', false); +}; + +PageBot.prototype.checkMultiselect = function(element) { + if (!element.multiple) + { + throw new SeleniumError("Not a multi-select"); + } + +}; + +PageBot.prototype.replaceText = function(element, stringValue) { + triggerEvent(element, 'focus', false); + triggerEvent(element, 'select', true); + element.value=stringValue; + if (!browserVersion.isChrome) { + // In chrome URL, The change event is already fired by setting the value. + triggerEvent(element, 'change', true); + } + triggerEvent(element, 'blur', false); +}; + +MozillaPageBot.prototype.clickElement = function(element) { + + triggerEvent(element, 'focus', false); + + // Add an event listener that detects if the default action has been prevented. + // (This is caused by a javascript onclick handler returning false) + var preventDefault = false; + + element.addEventListener("click", function(evt) {preventDefault = evt.getPreventDefault();}, false); + + // Trigger the click event. + triggerMouseEvent(element, 'click', true); + + // Perform the link action if preventDefault was set. + // In chrome URL, the link action is already executed by triggerMouseEvent. + if (!browserVersion.isChrome && !preventDefault) { + // Try the element itself, as well as it's parent - this handles clicking images inside links. + if (element.href) { + this.currentWindow.location.href = element.href; + } + else if (element.parentNode && element.parentNode.href) { + this.currentWindow.location.href = element.parentNode.href; + } + } + + if (this.windowClosed()) { + return; + } + + triggerEvent(element, 'blur', false); +}; + +OperaPageBot.prototype.clickElement = function(element) { + + triggerEvent(element, 'focus', false); + + // Trigger the click event. + triggerMouseEvent(element, 'click', true); + + if (isDefined(element.checked)) { + // In Opera, clicking won't check/uncheck + if (element.type == "checkbox") { + element.checked = !element.checked; + } else { + element.checked = true; + } + } + + if (this.windowClosed()) { + return; + } + + triggerEvent(element, 'blur', false); +}; + + +KonquerorPageBot.prototype.clickElement = function(element) { + + triggerEvent(element, 'focus', false); + + if (element.click) { + element.click(); + } + else { + triggerMouseEvent(element, 'click', true); + } + + if (this.windowClosed()) { + return; + } + + triggerEvent(element, 'blur', false); +}; + +SafariPageBot.prototype.clickElement = function(element) { + + triggerEvent(element, 'focus', false); + + var wasChecked = element.checked; + + // For form element it is simple. + if (element.click) { + element.click(); + } + // For links and other elements, event emulation is required. + else { + triggerMouseEvent(element, 'click', true); + + // Unfortunately, triggering the event doesn't seem to activate onclick handlers. + // We currently call onclick for the link, but I'm guessing that the onclick for containing + // elements is not being called. + var success = true; + if (element.onclick) { + var evt = document.createEvent('HTMLEvents'); + evt.initEvent('click', true, true); + var onclickResult = element.onclick(evt); + if (onclickResult === false) { + success = false; + } + } + + if (success) { + // Try the element itself, as well as it's parent - this handles clicking images inside links. + if (element.href) { + this.currentWindow.location.href = element.href; + } + else if (element.parentNode.href) { + this.currentWindow.location.href = element.parentNode.href; + } else { + // This is true for buttons outside of forms, and maybe others. + LOG.warn("Ignoring 'click' call for button outside form, or link without href." + + "Using buttons without an enclosing form can cause wierd problems with URL resolution in Safari." ); + // I implemented special handling for window.open, but unfortunately this behaviour is also displayed + // when we have a button without an enclosing form that sets document.location in the onclick handler. + // The solution is to always use an enclosing form for a button. + } + } + } + + if (this.windowClosed()) { + return; + } + + triggerEvent(element, 'blur', false); +}; + +IEPageBot.prototype.clickElement = function(element) { + + triggerEvent(element, 'focus', false); + + var wasChecked = element.checked; + + // Set a flag that records if the page will unload - this isn't always accurate, because + // <a href="javascript:alert('foo'):"> triggers the onbeforeunload event, even thought the page won't unload + var pageUnloading = false; + var pageUnloadDetector = function() {pageUnloading = true;}; + this.currentWindow.attachEvent("onbeforeunload", pageUnloadDetector); + + element.click(); + + // If the page is going to unload - still attempt to fire any subsequent events. + // However, we can't guarantee that the page won't unload half way through, so we need to handle exceptions. + try { + this.currentWindow.detachEvent("onbeforeunload", pageUnloadDetector); + + if (this.windowClosed()) { + return; + } + + // Onchange event is not triggered automatically in IE. + if (isDefined(element.checked) && wasChecked != element.checked) { + triggerEvent(element, 'change', true); + } + + triggerEvent(element, 'blur', false); + } + catch (e) { + // If the page is unloading, we may get a "Permission denied" or "Unspecified error". + // Just ignore it, because the document may have unloaded. + if (pageUnloading) { + LOG.warn("Caught exception when firing events on unloading page: " + e.message); + return; + } + throw e; + } +}; + +PageBot.prototype.windowClosed = function(element) { + return this.currentWindow.closed; +}; + +PageBot.prototype.bodyText = function() { + return getText(this.currentDocument.body); +}; + +PageBot.prototype.getAllButtons = function() { + var elements = this.currentDocument.getElementsByTagName('input'); + var result = ''; + + for (var i = 0; i < elements.length; i++) { + if (elements[i].type == 'button' || elements[i].type == 'submit' || elements[i].type == 'reset') { + result += elements[i].id; + + result += ','; + } + } + + return result; +}; + + +PageBot.prototype.getAllFields = function() { + var elements = this.currentDocument.getElementsByTagName('input'); + var result = ''; + + for (var i = 0; i < elements.length; i++) { + if (elements[i].type == 'text') { + result += elements[i].id; + + result += ','; + } + } + + return result; +}; + +PageBot.prototype.getAllLinks = function() { + var elements = this.currentDocument.getElementsByTagName('a'); + var result = ''; + + for (var i = 0; i < elements.length; i++) { + result += elements[i].id; + + result += ','; + } + + return result; +}; + +PageBot.prototype.setContext = function(strContext, logLevel) { + //set the current test title + document.getElementById("context").innerHTML=strContext; + if (logLevel!=null) { + LOG.setLogLevelThreshold(logLevel); + } +}; + +function isDefined(value) { + return typeof(value) != undefined; +} + +PageBot.prototype.goBack = function() { + this.currentWindow.history.back(); + if (browserVersion.isOpera && !selenium.browserbot.pollingForLoad) { + // DGF On Opera, goBack doesn't re-trigger a load event, so we have to poll for it + selenium.browserbot.callOnWindowPageTransition(selenium.browserbot.recordPageLoad, this.currentWindow); + } +}; + +PageBot.prototype.goForward = function() { + this.currentWindow.history.forward(); +}; + +PageBot.prototype.close = function() { + if (browserVersion.isChrome) { + this.currentWindow.close(); + } else { + this.currentWindow.eval("window.close();"); + } +}; + +PageBot.prototype.refresh = function() { + this.currentWindow.location.reload(true); +}; + +/** + * Refine a list of elements using a filter. + */ +PageBot.prototype.selectElementsBy = function(filterType, filter, elements) { + var filterFunction = PageBot.filterFunctions[filterType]; + if (! filterFunction) { + throw new SeleniumError("Unrecognised element-filter type: '" + filterType + "'"); + } + + return filterFunction(filter, elements); +}; + +PageBot.filterFunctions = {}; + +PageBot.filterFunctions.name = function(name, elements) { + var selectedElements = []; + for (var i = 0; i < elements.length; i++) { + if (elements[i].name === name) { + selectedElements.push(elements[i]); + } + } + return selectedElements; +}; + +PageBot.filterFunctions.value = function(value, elements) { + var selectedElements = []; + for (var i = 0; i < elements.length; i++) { + if (elements[i].value === value) { + selectedElements.push(elements[i]); + } + } + return selectedElements; +}; + +PageBot.filterFunctions.index = function(index, elements) { + index = Number(index); + if (isNaN(index) || index < 0) { + throw new SeleniumError("Illegal Index: " + index); + } + if (elements.length <= index) { + throw new SeleniumError("Index out of range: " + index); + } + return [elements[index]]; +}; + +PageBot.prototype.selectElements = function(filterExpr, elements, defaultFilterType) { + + var filterType = (defaultFilterType || 'value'); + + // If there is a filter prefix, use the specified strategy + var result = filterExpr.match(/^([A-Za-z]+)=(.+)/); + if (result) { + filterType = result[1].toLowerCase(); + filterExpr = result[2]; + } + + return this.selectElementsBy(filterType, filterExpr, elements); +}; + +/** + * Find an element by class + */ +PageBot.prototype.locateElementByClass = function(locator, document) { + return Element.findFirstMatchingChild(document, + function(element) { + return element.className == locator + } + ); +} + +/** + * Find an element by alt + */ +PageBot.prototype.locateElementByAlt = function(locator, document) { + return Element.findFirstMatchingChild(document, + function(element) { + return element.alt == locator + } + ); +} + |