Skip to main content

keys

Send a sequence of key strokes to the active element. You can also use characters like "Left arrow" or "Back space". WebdriverIO will take care of translating them into unicode characters. You’ll find all supported characters here. To do that, the value has to correspond to a key from the table.

Modifier like Ctrl, Shift, Alt and Meta will stay pressed so you need to trigger them again to release them. Modifiying a click however requires you to use the WebDriver Actions API through the performActions method.

Usage​
browser.keys(value)
Parameters​
NameTypeDetails
value
String, Array.<String>The sequence of keys to type. An array or string must be provided.
Example​
keys.js
it('copies text out of active element', async () => {
// copies text from an input element
const input = await $('#username')
await input.setValue('anonymous')

await browser.keys(['Meta', 'a'])
await browser.keys(['Meta', 'c'])
});