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-dom
SeleniumDom.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 = Selenium var browser = browserbody // => 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 andri@dot.ee or create an issue online.