/* * 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. // Although it's generally better web development practice not to use browser-detection // (feature detection is better), the subtle browser differences that Selenium has to // work around seem to make it necessary. Maybe as we learn more about what we need, // we can do this in a more "feature-centric" rather than "browser-centric" way. // TODO we should probably reuse an available browser-detection library var browserName=navigator.appName; var isIE = (browserName =="Microsoft Internet Explorer"); var isKonqueror = (browserName == "Konqueror"); var isSafari = (navigator.userAgent.indexOf('Safari') != -1); // Get the Gecko version as an 8 digit date. var geckoResult = /^Mozilla\/5\.0 .*Gecko\/(\d{8}).*$/.exec(navigator.userAgent); var geckoVersion = geckoResult == null ? null : geckoResult[1]; 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; var self = this; this.recordPageLoad = function() { LOG.debug("Page load detected, location=" + self.getCurrentWindow().location); self.currentPage = null; self.newPageLoaded = true; }; this.isNewPageLoaded = function() { return self.newPageLoaded; }; }; BrowserBot.createForFrame = function(frame) { var browserbot; if (isIE) { browserbot = new IEBrowserBot(frame); } else if (isKonqueror) { browserbot = new KonquerorBrowserBot(frame); } else if (isSafari) { browserbot = new SafariBrowserBot(frame); } else { // 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.setIFrameLocation(this.getFrame(), target); }; BrowserBot.prototype.setIFrameLocation = function(iframe, location) { iframe.src = 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 with an "unload" handler which attaches a "load" handler. */ BrowserBot.prototype.callOnWindowPageTransition = function(loadFunction, windowObject) { var attachLoadListener = function() { if (windowObject && !windowObject.closed) { addLoadListener(windowObject, loadFunction); } }; var unloadFunction = function() { window.setTimeout(attachLoadListener, 0); }; addUnloadListener(windowObject, unloadFunction); }; 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; }; /** * 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. */ KonquerorBrowserBot.prototype.callOnWindowPageTransition = function(loadFunction, windowObject) { // Since the unload event doesn't fire in Safari 1.3, we start polling immediately // This works in Konqueror as well if (windowObject && !windowObject.closed) { LOG.debug("Starting pollForLoad"); this.pollForLoad(loadFunction, windowObject, windowObject.document); } }; /** * For Konqueror (and Safari), we can't catch the onload event for a separate window (as opposed to an IFrame) * So we 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 check to see that the completed document * is different from the original one. */ KonquerorBrowserBot.prototype.pollForLoad = function(loadFunction, windowObject, originalDocument) { if (windowObject.closed) { return; } var sameDoc = (originalDocument === windowObject.document); var rs = windowObject.document.readyState; if (!sameDoc && rs == 'complete') { LOG.debug("pollForLoad complete: " + rs + " (" + sameDoc + ")"); loadFunction(); return; } var self = this; LOG.debug("pollForLoad continue"); window.setTimeout(function() {self.pollForLoad(loadFunction, windowObject, originalDocument);}, 500); }; function SafariBrowserBot(frame) { BrowserBot.call(this, frame); } SafariBrowserBot.prototype = new BrowserBot; SafariBrowserBot.prototype.setIFrameLocation = KonquerorBrowserBot.prototype.setIFrameLocation; SafariBrowserBot.prototype.callOnWindowPageTransition = KonquerorBrowserBot.prototype.callOnWindowPageTransition; SafariBrowserBot.prototype.pollForLoad = KonquerorBrowserBot.prototype.pollForLoad; function IEBrowserBot(frame) { BrowserBot.call(this, frame); } IEBrowserBot.prototype = new BrowserBot; IEBrowserBot.prototype.callOnWindowPageTransition = KonquerorBrowserBot.prototype.callOnWindowPageTransition; IEBrowserBot.prototype.pollForLoad = KonquerorBrowserBot.prototype.pollForLoad; 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); }; }; 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 (isIE) { return new IEPageBot(windowObject); } else if (isKonqueror) { return new KonquerorPageBot(windowObject); } else if (isSafari) { return new SafariPageBot(windowObject); } else { // Use mozilla by default return new MozillaPageBot(windowObject); } }; MozillaPageBot = function(pageWindow) { PageBot.call(this, pageWindow); }; MozillaPageBot.prototype = new PageBot(); KonquerorPageBot = function(pageWindow) { PageBot.call(this, pageWindow); }; KonquerorPageBot.prototype = new PageBot(); SafariPageBot = function(pageWindow) { PageBot.call(this, pageWindow); }; SafariPageBot.prototype = new PageBot(); IEPageBot = function(pageWindow) { PageBot.call(this, pageWindow); }; IEPageBot.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 (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) { if (isIE && !inDocument.evaluate) { addXPathSupport(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 XPathContext(); context.expressionContextNode = inDocument; var xpathResult = new XPathParser().parse(xpath).evaluate(context); if (xpathResult && xpathResult.toArray) { return xpathResult.toArray()[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 (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, option) { triggerEvent(element, 'focus', false); if (!option.selected) { option.selected = true; triggerEvent(element, 'change', true); } triggerEvent(element, 'blur', false); }; PageBot.prototype.replaceText = function(element, stringValue) { triggerEvent(element, 'focus', false); triggerEvent(element, 'select', true); element.value=stringValue; 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; if (geckoVersion) { element.addEventListener("click", function(evt) {preventDefault = evt.getPreventDefault();}, false); } // Trigger the click event. triggerMouseEvent(element, 'click', true); // In FireFox < 1.0 Final, and Mozilla <= 1.7.3, just sending the click event is enough. // But in newer versions, we need to do it ourselves. var needsProgrammaticClick = (geckoVersion > '20041025'); // Perform the link action if preventDefault was set. if (needsProgrammaticClick && !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); }; 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 { triggerEvent(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. } } } // Onchange event is not triggered automatically in Safari. if (isDefined(element.checked) && wasChecked != element.checked) { triggerEvent(element, 'change', true); } 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 // 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) { //set the current test title context.innerHTML=strContext; }; function isDefined(value) { return typeof(value) != undefined; } PageBot.prototype.goBack = function() { this.currentWindow.history.back(); }; PageBot.prototype.goForward = function() { this.currentWindow.history.forward(); }; PageBot.prototype.close = function() { this.currentWindow.close(); }; /** * 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); };