鍵盤操作

代表任何與網頁互動的鍵盤輸入裝置。

鍵盤只能完成 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)