@testim/testim-cli
Version:
Command line interface for running Testing on you CI
67 lines (57 loc) • 1.96 kB
Markdown
name: bindingscommands
category: usage
tags: guide
index: 2
title: WebdriverIO - Bindings & Commands
Bindings & Commands
=====================
WebdriverIO differentiates between two different method types: protocol bindings and commands. Protocol bindings
are the exact representation of the JSONWire protocol interface. They expect the same parameters as described
in the [protocol docs](https://code.google.com/p/selenium/wiki/JsonWireProtocol#Command_Detail).
```js
client.element().then(function(result) {
console.log(result);
/**
* returns:
*
* { state: null,
* sessionId: '684cb251-f0bd-4910-a43d-f3413206e652',
* hCode: 2611472,
* value: { ELEMENT: '0' },
* class: 'org.openqa.selenium.remote.Response',
* status: 0 } }
*
*/
});
```
Since version `2.0.0` WebdriverIO has all JSONWire protocol bindings implemented and even a whole bunch of [Appium](http://appium.io/)
specific ones for mobile testing.
All other methods like `getCssProperty` or `dragAndDrop` using these commands to provide handy functions who simplify
your tests to look more concise and expressive. So instead of doing this:
```js
client.element('#myElem').then(function(res) {
assert(err === null);
client.elementIdCssProperty(res.value.ELEMENT, 'width').then(function(res) {
assert(res.value === '100px');
});
});
```
you can simply do this:
```js
client.getCssProperty('#myElem', 'width').then(function(width) {
assert(width.parsed.value === 100);
/**
* console.log(width) returns:
*
* { property: 'width',
* value: '100px',
* parsed: { type: 'number', string: '100px', unit: 'px', value: 100 } }
*/
});
```
It not only shortens your code it also makes the return value testable. You don't have to worry about how to combine
the JSONWire bindings to achieve a certain action, just use the command methods.