selenium-dom
v1.0.0
Published
A mixin library for Selenium WebDriver that adds DOM compatible functions to WebDriver and WebElement. Use a more standarized API for your tests.
Downloads
37
Readme
SeleniumDom.js
SeleniumDom.js is a mixin library for Node.js's Selenium WebDriver that adds DOM methods to Selenium's WebDriver and WebElement. That allows you to locate and query elements with a more standardized API and to share test code between integration tests using Selenium and unit tests using something like JSDOM. Very handy for the page object pattern.
SeleniumDom.js supports Selenium WebDriver v2.
Installing
npm install selenium-domSeleniumDom.js follows semantic versioning, so feel free to depend on its major version with something like >= 1.0.0 < 2 (a.k.a ^1.0.0).
Using
var Selenium = require("selenium-webdriver")
require("selenium-dom")(Selenium)
var browser = new Selenium.Builder().build()
browser.body // => WebElementPromise of `<body>`.API
For extended documentation on all functions, please see the SeleniumDom.js API Documentation.
SeleniumDom
WebDriver
- body
- .prototype.elementFromPoint(x, y)
- .prototype.getElementById(selector, [timeout])
- .prototype.querySelector(selector, [timeout])
- .prototype.querySelectorAll(selector)
WebElement
- classList
- textContent
- value
- .prototype.closest(selector)
- .prototype.querySelector(selector, [timeout])
- .prototype.querySelectorAll(selector)
- .prototype.scrollIntoView([options])
License
SeleniumDom.js is released under a Lesser GNU Affero General Public License, which in summary means:
- You can use this program for no cost.
- You can use this program for both personal and commercial reasons.
- You do not have to share your own program's code which uses this program.
- You have to share modifications (e.g. bug-fixes) you've made to this program.
For more convoluted language, see the LICENSE file.
About
Andri Möll typed this and the code.
Monday Calendar supported the engineering work.
If you find SeleniumDom.js needs improving, please don't hesitate to type to me now at [email protected] or create an issue online.