sendKeys()

Estimated reading: 5 minutes 21 views

Overview

The sendKeys() method in Selenium WebDriver is used to simulate typing text into an input field or a text area. It sends a series of keystrokes to an element, simulating user input. This method can be applied to various input elements, such as text fields, password fields, search boxes, and more.

This method is versatile as it can also be used to simulate keyboard shortcuts or key combinations by sending special keys (like ENTER, TAB, ESC, etc.). It is one of the most commonly used methods in WebDriver tests for automating form submissions or simulating user typing.

Syntax

				
					WebElement element = driver.findElement(By.id("elementID"));
element.sendKeys("text to type");

You can also use it with key events:

				
					element.sendKeys(Keys.ENTER);  // To simulate pressing the ENTER key

Usage

The sendKeys() method is used for:

Typing Text: Simulates entering text into form fields or text areas.
Simulating Keyboard Shortcuts: Sending special keys like ENTER, TAB, ESC, or BACKSPACE to trigger specific actions on the page.
Filling Forms: Automating the process of filling out forms during test execution.
Simulating User Interaction: Mimicking the real user interaction of typing in input fields.

Example Code for sendKeys()

Here’s a simple example of using sendKeys() to type into a text field and submit a form:

				
					import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.WebElement;

public class SendKeysExample {
    public static void main(String[] args) {
        // Set up WebDriver
        System.setProperty("webdriver.chrome.driver", "path/to/chromedriver");
        WebDriver driver = new ChromeDriver();

        // Navigate to a sample webpage with a form
        driver.get("https://www.example.com");

        // Locate the input field
        WebElement inputField = driver.findElement(By.id("username"));

        // Send text to the input field
        inputField.sendKeys("testuser");

        // Locate and submit the form (e.g., by pressing Enter)
        inputField.submit();  // Alternatively, you can use sendKeys(Keys.ENTER)

        // Close the browser
        driver.quit();
    }
}

sendKeys() in Actions Class

In addition to the standard use of sendKeys() on WebElement objects, it can also be used with the Actions class for more advanced scenarios, such as when you want to simulate pressing multiple keys simultaneously or when interacting with complex user interface elements that require holding down a modifier key (like Shift, Ctrl, or Alt) while typing.

Usage of sendKeys() with Actions Class

The Actions class provides methods to simulate advanced keyboard actions, including sending key sequences with modifier keys, which cannot be easily performed with the standard sendKeys() method on WebElements.

Syntax with Actions Class

				
					Actions actions = new Actions(driver);
actions.sendKeys(element, "text to type").perform();

This can also be used with special key combinations such as pressing Ctrl + A or Ctrl + C to simulate copy actions or select all text.

Example Code using sendKeys() in Actions Class

Here’s an example of using sendKeys() in the Actions class to type text and use keyboard shortcuts:

				
					import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.interactions.Actions;
import org.openqa.selenium.Keys;

public class ActionsSendKeysExample {
    public static void main(String[] args) {
        // Set up WebDriver
        System.setProperty("webdriver.chrome.driver", "path/to/chromedriver");
        WebDriver driver = new ChromeDriver();

        // Navigate to a sample webpage with a form
        driver.get("https://www.example.com");

        // Locate the input field
        WebElement inputField = driver.findElement(By.id("username"));

        // Initialize the Actions class
        Actions actions = new Actions(driver);

        // Type text into the input field using Actions class
        actions.sendKeys(inputField, "testuser").perform();

        // Use a keyboard shortcut, for example, Ctrl+A to select all text
        actions.sendKeys(Keys.CONTROL, "a").perform();

        // Close the browser
        driver.quit();
    }
}

Key Features of sendKeys()

Simulate Typing: Mimics typing text into text fields, password fields, and other input elements.
Simulate Key Combinations: You can use special keys to simulate keyboard shortcuts, such as pressing ENTER, TAB, Ctrl + A, or Esc.
Works with WebElements: You can directly interact with any input element that can accept text input or trigger key events.
Supports Modifier Keys: In combination with the Actions class, you can simulate key presses with modifier keys (e.g., Shift, Ctrl, Alt) for advanced user interactions.

Importance

The sendKeys() method is one of the most widely used methods in Selenium WebDriver to automate tasks that involve form filling, sending input, or simulating key presses. It is essential for automating interactions with web applications that require keyboard input, and it works seamlessly with both simple input fields and complex UI elements.

Limitations

Does not simulate all key presses: Some advanced key combinations (e.g., Ctrl + Tab for switching tabs) may require additional handling or may not work in certain environments or browsers.
Performance Issues with Large Text: When sending large amounts of text, performance may degrade, especially in scenarios where you need to type long strings character by character.

Conclusion

The sendKeys() method is a versatile and essential tool in Selenium WebDriver for simulating keyboard input in automation scripts. Whether it’s typing in a form field, simulating keyboard shortcuts, or using the Actions class for complex key events, this method allows testers to automate a wide range of user interactions. Combined with other WebDriver actions, it helps in creating highly realistic and accurate automated tests for web applications.