键盘操作

表示与网页交互的任何按键输入设备。

使用键盘只能完成 2 个操作：按下按键和松开按下的按键。除了支持 ASCII 字符外，每个键盘按键都有一个表示，可以按指定顺序按下或松开。

按键

除了用常规 Unicode 表示的按键外，还为其他键盘按键分配了 Unicode 值，以用于 Selenium。每种语言都有其自己的引用这些按键的方式；完整列表可以在此处找到。

使用 Java Keys 枚举

使用 Python Keys 类

使用 .NET 静态 Keys 类

使用 Ruby KEYS 常量

使用 JavaScript KEYS 常量

使用 Java Keys 枚举

按下按键

        new Actions(driver)
                .keyDown(Keys.SHIFT)
                .sendKeys("a")
                .perform();
在 GitHub 上查看完整示例
    ActionChains(driver)\
        .key_down(Keys.SHIFT)\
        .send_keys("abc")\
        .perform()
在 GitHub 上查看完整示例
                .KeyDown(Keys.Shift)
                .SendKeys("a")
                .Perform();
在 GitHub 上查看完整示例
    driver.action
          .key_down(:shift)
          .send_keys('a')
          .perform
在 GitHub 上查看完整示例
    await driver.actions()
      .keyDown(Key.SHIFT)
      .sendKeys('a')
      .perform()
在 GitHub 上查看完整示例
        Actions(driver)
                .keyDown(Keys.SHIFT)
                .sendKeys("a")
                .perform()
在 GitHub 上查看完整示例

松开按键

        new Actions(driver)
                .keyDown(Keys.SHIFT)
                .sendKeys("a")
                .keyUp(Keys.SHIFT)
                .sendKeys("b")
                .perform();
在 GitHub 上查看完整示例
    ActionChains(driver)\
        .key_down(Keys.SHIFT)\
        .send_keys("a")\
        .key_up(Keys.SHIFT)\
        .send_keys("b")\
        .perform()
在 GitHub 上查看完整示例
            new Actions(driver)
                .KeyDown(Keys.Shift)
                .SendKeys("a")
                .KeyUp(Keys.Shift)
                .SendKeys("b")
                .Perform();
在 GitHub 上查看完整示例
    driver.action
          .key_down(:shift)
          .send_keys('a')
          .key_up(:shift)
          .send_keys('b')
          .perform
在 GitHub 上查看完整示例
    await driver.actions()
      .keyDown(Key.SHIFT)
      .sendKeys('a')
      .keyUp(Key.SHIFT)
      .sendKeys('b')
      .perform()
在 GitHub 上查看完整示例
        Actions(driver)
                .keyDown(Keys.SHIFT)
                .sendKeys("a")
                .keyUp(Keys.SHIFT)
                .sendKeys("b")
                .perform()
在 GitHub 上查看完整示例

发送按键

这是 Actions API 中的一个便捷方法，它在一个操作中组合了 keyDown 和 keyUp 命令。执行此命令与使用元素方法略有不同，但主要用于需要在其他操作中间输入多个字符时。

活动元素

        new Actions(driver)
                .sendKeys("abc")
                .perform();
在 GitHub 上查看完整示例
    ActionChains(driver)\
        .send_keys("abc")\
        .perform()
在 GitHub 上查看完整示例

            new Actions(driver)
                .SendKeys("abc")
在 GitHub 上查看完整示例
    driver.action
          .send_keys('abc')
          .perform
在 GitHub 上查看完整示例
    await driver.actions()
      .sendKeys('abc')
      .perform()
在 GitHub 上查看完整示例
        Actions(driver)
                .sendKeys("abc")
                .perform()
在 GitHub 上查看完整示例

指定元素

        new Actions(driver)
                .sendKeys(textField, "Selenium!")
                .perform();
在 GitHub 上查看完整示例
    text_input = driver.find_element(By.ID, "textInput")
    ActionChains(driver)\
        .send_keys_to_element(text_input, "abc")\
        .perform()
在 GitHub 上查看完整示例
            driver.FindElement(By.TagName("body")).Click();
            
            IWebElement textField = driver.FindElement(By.Id("textInput"));
            new Actions(driver)
在 GitHub 上查看完整示例
    text_field = driver.find_element(id: 'textInput')
    driver.action
          .send_keys(text_field, 'Selenium!')
          .perform
在 GitHub 上查看完整示例

Selenium v4.5.0

    const textField = await driver.findElement(By.id('textInput'))

    await driver.actions()
      .sendKeys(textField, 'abc')
      .perform()
在 GitHub 上查看完整示例
        val textField = driver.findElement(By.id("textInput"))
        Actions(driver)
                .sendKeys(textField, "Selenium!")
                .perform()
在 GitHub 上查看完整示例

复制和粘贴

以下是使用上述所有方法执行复制/粘贴操作的示例。请注意，此操作使用的按键会因是否为 Mac OS 而异。此代码最终会得到文本：SeleniumSelenium!

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

        WebElement textField = driver.findElement(By.id("textInput"));
        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();

        Assertions.assertEquals("SeleniumSelenium!", textField.getAttribute("value"));
在 GitHub 上查看完整示例
    cmd_ctrl = Keys.COMMAND if sys.platform == 'darwin' else Keys.CONTROL

    ActionChains(driver)\
        .send_keys("Selenium!")\
        .send_keys(Keys.ARROW_LEFT)\
        .key_down(Keys.SHIFT)\
        .send_keys(Keys.ARROW_UP)\
        .key_up(Keys.SHIFT)\
        .key_down(cmd_ctrl)\
        .send_keys("xvv")\
        .key_up(cmd_ctrl)\
        .perform()
在 GitHub 上查看完整示例

            var capabilities = ((WebDriver)driver).Capabilities;
            String platformName = (string)capabilities.GetCapability("platformName");

            String cmdCtrl = platformName.Contains("mac") ? Keys.Command : Keys.Control;

            new Actions(driver)
                .SendKeys("Selenium!")
                .SendKeys(Keys.ArrowLeft)
                .KeyDown(Keys.Shift)
                .SendKeys(Keys.ArrowUp)
在 GitHub 上查看完整示例
    cmd_ctrl = driver.capabilities.platform_name.include?('mac') ? :command : :control
    driver.action
          .send_keys('Selenium!')
          .send_keys(:arrow_left)
          .key_down(:shift)
          .send_keys(:arrow_up)
          .key_up(:shift)
          .key_down(cmd_ctrl)
          .send_keys('xvv')
          .key_up(cmd_ctrl)
          .perform
在 GitHub 上查看完整示例
    const cmdCtrl = platform.includes('darwin') ? Key.COMMAND : Key.CONTROL

    await driver.actions()
      .click(textField)
      .sendKeys('Selenium!')
      .sendKeys(Key.ARROW_LEFT)
      .keyDown(Key.SHIFT)
      .sendKeys(Key.ARROW_UP)
      .keyUp(Key.SHIFT)
      .keyDown(cmdCtrl)
      .sendKeys('xvv')
      .keyUp(cmdCtrl)
      .perform()
在 GitHub 上查看完整示例
        val cmdCtrl = if(platformName == Platform.MAC) Keys.COMMAND else Keys.CONTROL

        val textField = driver.findElement(By.id("textInput"))
        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()
在 GitHub 上查看完整示例
上次修改时间：2024 年 8 月 4 日：refactor[js]: 更新代码示例以使用 mocha 并更新文档 (4e38f3fbcdd)