Keyboard Actions with Selenium Actions Class

Simulating advanced typing, selection, and keyboard shortcuts using Actions and Keys in Java

Concept

In this practice lab, you will learn how to simulate real keyboard behavior in Selenium using the Actions class and the Keys enum.

Instead of only using element.sendKeys("text"), you will:

Hold and release modifier keys like Shift, Control, or Command
Use arrow keys to move the text cursor
Use keyboard shortcuts like copy and paste
Type either into a specific element or into the currently focused element

Actions class

Actions is used to build complex user interactions step by step (keyboard, mouse, or combined).

You can chain multiple operations: keyDown(), sendKeys(), keyUp(), etc.
The actions only run when you call .perform() at the end

When to use it

When you need combinations like Shift + Arrow to select text
When you need Ctrl/Cmd shortcuts (copy, paste, cut, select-all)
When simple element.sendKeys() is not enough

Best Practice

Keep action chains short and readable. Group related keyboard steps together in one Actions chain, and always end with .perform().

Keys enum

Keys provides special keys: SHIFT, CONTROL, COMMAND, ENTER, TAB, ARROW_LEFT, ARROW_UP, etc.

Instead of magic strings, you use Keys.SOMETHING for clarity and stability.

When to use it

Any time you need a non-character key (moving the caret with arrows, holding Shift for selection, using Ctrl/Cmd for shortcuts)
To make your code self-documenting (easy to understand later)

Best Practice

Use Keys instead of hard-coded key codes or strange characters. For cross-platform shortcuts, detect Mac vs non-Mac and pick Keys.COMMAND or Keys.CONTROL.

Active element vs designated element

Designated element:

actions.sendKeys(textField, "Selenium!")

Focuses the given element and types text into it
More explicit and less fragile

Active element:

actions.sendKeys("abc")

Types into whichever element currently has focus
Useful when your test already clicked into the right field

Best Practice

Prefer designated elements in tests for stability. Use active element style only when the app manages focus in a reliable way.

Interactive Practice

In this practice, imagine a simple page called "Keyboard Playground".

Keyboard Playground

Interact with the form directly to see how Selenium would locate these elements!

Manual interaction (what a user would do)

Click inside the Text input field.
Type the text: Selenium!
Use the Left Arrow once to move the caret one position to the left.
Hold Shift and press the Up Arrow to select the whole text.
Hold Ctrl (or Command on Mac) and press:
- X to cut the selection.
- V twice to paste the same text two times.
Final content in the Text input field becomes: SeleniumSelenium!

Your Selenium script will perform these exact keyboard steps using Actions and Keys.

Java Code Example

KeyboardActions.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
WebElement textField = driver.findElement(By.id("textInput"));

Keys cmdCtrl = Platform.getCurrent().is(Platform.MAC) ? Keys.COMMAND : Keys.CONTROL;

new Actions(driver)
        .sendKeys(textField, "Selenium!")
        .sendKeys(Keys.ARROW_LEFT)
        .keyDown(Keys.SHIFT)
        .sendKeys(Keys.ARROW_UP)
        .keyUp(Keys.SHIFT)
        .keyDown(cmdCtrl)
        .sendKeys("xvv")
        .keyUp(cmdCtrl)
        .perform();

driver.quit();

Code Breakdown

driver.findElement(By.id("textInput")): Locates the Text input field using its id="textInput".
Keys cmdCtrl = Platform.getCurrent().is(Platform.MAC) ? Keys.COMMAND : Keys.CONTROL;: Chooses the correct modifier key for shortcuts: COMMAND on Mac, CONTROL on other operating systems.
new Actions(driver): Creates a new Actions builder instance linked to the current driver.
sendKeys(textField, "Selenium!"): Focuses the textField and types the text "Selenium!" into it.
sendKeys(Keys.ARROW_LEFT): Presses the Left Arrow once to move the caret one position to the left.
keyDown(Keys.SHIFT): Holds down Shift, preparing to select text with the next key press.
sendKeys(Keys.ARROW_UP): While Shift is held, presses Up Arrow, which selects the entire line in many single-line inputs.
keyUp(Keys.SHIFT): Releases the Shift key; the text stays selected.
keyDown(cmdCtrl): Holds down the platform-specific Ctrl/Cmd modifier key.
sendKeys("xvv"): Sends the characters "xvv" while Ctrl/Cmd is held:
x → Cut the selected text
First v → Paste once
Second v → Paste again, resulting in SeleniumSelenium!
keyUp(cmdCtrl): Releases the Ctrl/Cmd key, ending the shortcut sequence.
perform(): Executes the entire chain of queued keyboard actions in order.
driver.quit(): Closes the browser and ends the WebDriver session once the lab scenario is complete.

Pro Tip

Explicit Element Targeting

Prefer explicit element targeting (sendKeys(textField, "...")) over relying on the active element. It makes your tests more stable and easier to debug.

Keep Chains Readable

Keep keyboard action chains small and readable. If a chain becomes too long, split it into logical steps for better maintainability and debugging.

Use Keys Enum

Always use the Keys enum (e.g. Keys.SHIFT, Keys.ARROW_LEFT) instead of magic values; this makes shortcuts and cursor movements self-explanatory for anyone reading your test.

Concept

In this practice lab, you will learn how to simulate real keyboard behavior in Selenium using the Actions class and the Keys enum.

Instead of only using element.sendKeys("text"), you will:

Hold and release modifier keys like Shift, Control, or Command

Use arrow keys to move the text cursor

Use keyboard shortcuts like copy and paste

Type either into a specific element or into the currently focused element

Actions class

Actions is used to build complex user interactions step by step (keyboard, mouse, or combined).

You can chain multiple operations: keyDown(), sendKeys(), keyUp(), etc.
The actions only run when you call .perform() at the end

When to use it

When you need combinations like Shift + Arrow to select text
When you need Ctrl/Cmd shortcuts (copy, paste, cut, select-all)
When simple element.sendKeys() is not enough

Best Practice

Keep action chains short and readable. Group related keyboard steps together in one Actions chain, and always end with .perform().

Keys enum

Keys provides special keys: SHIFT, CONTROL, COMMAND, ENTER, TAB, ARROW_LEFT, ARROW_UP, etc.

Instead of magic strings, you use Keys.SOMETHING for clarity and stability.

When to use it

Any time you need a non-character key (moving the caret with arrows, holding Shift for selection, using Ctrl/Cmd for shortcuts)
To make your code self-documenting (easy to understand later)

Best Practice

Use Keys instead of hard-coded key codes or strange characters. For cross-platform shortcuts, detect Mac vs non-Mac and pick Keys.COMMAND or Keys.CONTROL.

Active element vs designated element

Designated element:

actions.sendKeys(textField, "Selenium!")

Focuses the given element and types text into it
More explicit and less fragile

Active element:

actions.sendKeys("abc")

Types into whichever element currently has focus
Useful when your test already clicked into the right field

Best Practice

Prefer designated elements in tests for stability. Use active element style only when the app manages focus in a reliable way.

Interactive Practice

In this practice, imagine a simple page called "Keyboard Playground".

Keyboard Playground

Interact with the form directly to see how Selenium would locate these elements!

Manual interaction (what a user would do)

Click inside the Text input field.
Type the text: Selenium!
Use the Left Arrow once to move the caret one position to the left.
Hold Shift and press the Up Arrow to select the whole text.
Hold Ctrl (or Command on Mac) and press:
- X to cut the selection.
- V twice to paste the same text two times.
Final content in the Text input field becomes: SeleniumSelenium!

Your Selenium script will perform these exact keyboard steps using Actions and Keys.

Java Code Example

KeyboardActions.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
WebElement textField = driver.findElement(By.id("textInput"));

Keys cmdCtrl = Platform.getCurrent().is(Platform.MAC) ? Keys.COMMAND : Keys.CONTROL;

new Actions(driver)
        .sendKeys(textField, "Selenium!")
        .sendKeys(Keys.ARROW_LEFT)
        .keyDown(Keys.SHIFT)
        .sendKeys(Keys.ARROW_UP)
        .keyUp(Keys.SHIFT)
        .keyDown(cmdCtrl)
        .sendKeys("xvv")
        .keyUp(cmdCtrl)
        .perform();

driver.quit();

Code Breakdown

driver.findElement(By.id("textInput")): Locates the Text input field using its id="textInput".
Keys cmdCtrl = Platform.getCurrent().is(Platform.MAC) ? Keys.COMMAND : Keys.CONTROL;: Chooses the correct modifier key for shortcuts: COMMAND on Mac, CONTROL on other operating systems.
new Actions(driver): Creates a new Actions builder instance linked to the current driver.
sendKeys(textField, "Selenium!"): Focuses the textField and types the text "Selenium!" into it.
sendKeys(Keys.ARROW_LEFT): Presses the Left Arrow once to move the caret one position to the left.
keyDown(Keys.SHIFT): Holds down Shift, preparing to select text with the next key press.
sendKeys(Keys.ARROW_UP): While Shift is held, presses Up Arrow, which selects the entire line in many single-line inputs.
keyUp(Keys.SHIFT): Releases the Shift key; the text stays selected.
keyDown(cmdCtrl): Holds down the platform-specific Ctrl/Cmd modifier key.
sendKeys("xvv"): Sends the characters "xvv" while Ctrl/Cmd is held:
x → Cut the selected text
First v → Paste once
Second v → Paste again, resulting in SeleniumSelenium!
keyUp(cmdCtrl): Releases the Ctrl/Cmd key, ending the shortcut sequence.
perform(): Executes the entire chain of queued keyboard actions in order.
driver.quit(): Closes the browser and ends the WebDriver session once the lab scenario is complete.

Pro Tip

Explicit Element Targeting

Prefer explicit element targeting (sendKeys(textField, "...")) over relying on the active element. It makes your tests more stable and easier to debug.

Keep Chains Readable

Keep keyboard action chains small and readable. If a chain becomes too long, split it into logical steps for better maintainability and debugging.

Use Keys Enum

Always use the Keys enum (e.g. Keys.SHIFT, Keys.ARROW_LEFT) instead of magic values; this makes shortcuts and cursor movements self-explanatory for anyone reading your test.