Common API Call Examples

Find a single element

var something = browser.findElement({css:'.something'}); //something is a promise

Type in an element/input

something.sendKeys('else');

Find multiple elements

Working example leveraging the page objects pattern

Complex mouses operations using action chains:

browser.actions().mouseDown(element).mouseMove(location).mouseUp().perform();
//a.k.a.
browser.actions().dragAndDrop(element,location).perform();

Set a custom wait for findElement(s), use judiciously

browser.manage().timeouts().implicitlyWait(10000);
//do something
browser.manage().timeouts().implicitlyWait(5000);
//if you forget to reset the timeout it will only effect the remaining tests in same file

Wait for a condition to be true before moving on with a test, selenium api calls following this call will not be executed until the wait completes (see control flows):

/*
 * wait understands booleans, they can be directly returned or the result of a promise
 */
browser.wait(function() {
 return driver.getTitle().then(function(title) {
   return title === 'webdriver';
 });
}, 1000); //wait for the result to be true or 1 second, this overrides implcit wait