Operaciones de ratón y teclado de Selenium

Selenium ofrece amplias funciones de operación de ratón y teclado, que pueden simular las interacciones del usuario, como hacer clic, doble clic, arrastrar y soltar, hover, ingresar texto, pulsar combinaciones de teclas, etc.

A continuación se presentan las operaciones de ratón y teclado más comunes en Selenium y sus descripciones:

Operaciones de ratón

Tipo de operaciónMétodoDescripción
Clicclick(element)oclick()Hace clic en el elemento especificado o en la posición actual del ratón.
Doble clicdouble_click(element)odouble_click()Hace doble clic en el elemento especificado o en la posición actual del ratón.
Clic derechocontext_click(element)ocontext_click()Hace clic derecho en el elemento especificado o en la posición actual del ratón.
Arrastrar y soltardrag_and_drop(source, target)Arrastra el elemento de origen y lo suelta sobre el elemento de destino.
Hovermove_to_element(element)Mueve el ratón sobre el elemento especificado.
Mantener presionado y soltarclick_and_hold(element)yrelease()Mantiene presionado el elemento especificado y lo suelta, utilizado para implementar operaciones de arrastre.

Operaciones de teclado

Tipo de operaciónMétodoDescripción
Ingresar textosend_keys("text")Ingresa el texto especificado en un campo de entrada o área de texto.
Pulsar combinación de teclassend_keys(Keys.CONTROL + 'a')Simula pulsar una combinación de teclas (como Ctrl + A).
Pulsar una tecla individualsend_keys(Keys.KEY_NAME)Simula pulsar una tecla individual (como Enter, Tab, Shift, etc.).
Soltar teclakey_up(key)Suelta la tecla pulsada.

Valores comunes de teclas

Valor de teclaDescripción
Keys.ENTERTecla Enter
Keys.TABTecla Tab
Keys.SHIFTTecla Shift
Keys.CONTROLTecla Ctrl
Keys.ALTTecla Alt
Keys.ESCAPETecla Esc
Keys.BACKSPACETecla de retroceso
Keys.SPACETecla de espacio
Keys.ARROW_UPTecla de flecha hacia arriba
Keys.ARROW_DOWNTecla de flecha hacia abajo
Keys.ARROW_LEFTTecla de flecha hacia la izquierda
Keys.ARROW_RIGHTTecla de flecha hacia la derecha

Operaciones de ratón (clase ActionChains)

En Selenium, las operaciones de ratón se implementan principalmente mediante laActionChainsclase.ActionChainsLa clase nos permite ejecutar operaciones complejas de ratón, como clic, doble clic, clic derecho, arrastrar y soltar y hover, etc.

Clic, doble clic y clic derecho

  1. Clic (Click): Simula la operación de clic con el botón izquierdo del ratón.
  2. Doble clic (Double Click): Simula la operación de doble clic con el botón izquierdo del ratón.
  3. Clic derecho (Right Click): Simula la operación de clic con el botón derecho del ratón.

Ejemplo

from selenium import webdriver
from selenium.webdriver.chrome.service import Service as ChromeService
from selenium.webdriver.common.action_chains import ActionChains
from selenium.webdriver.common.by import By

# Establecer la ruta correcta del controlador
service = ChromeService(executable_path="./chromedriver-mac-arm64/chromedriver")
options = webdriver.ChromeOptions()
driver = webdriver.Chrome(service=service, options=options)


# Abrir la página web
driver.get("https://example.com")

# Localizar el elemento
element = driver.find_element(By.ID, "element_id")

# Crear el objeto ActionChains
actions = ActionChains(driver)

# Operación de clic
actions.click(element).perform()

# Operación de doble clic
actions.double_click(element).perform()

# Operación de clic derecho
actions.context_click(element).perform()

# Cerrar el navegador
driver.quit()

Operación de arrastrar y soltar

La operación de arrastrar y soltar consiste en arrastrar un elemento a otra posición o sobre otro elemento.

Ejemplo

from selenium import webdriver
from selenium.webdriver.chrome.service import Service as ChromeService
from selenium.webdriver.common.action_chains import ActionChains
from selenium.webdriver.common.by import By

# Establecer la ruta correcta del controlador
service = ChromeService(executable_path="./chromedriver-mac-arm64/chromedriver")
options = webdriver.ChromeOptions()
driver = webdriver.Chrome(service=service, options=options)


# Abrir la página web
driver.get("https://example.com")

# Localizar el elemento a arrastrar y el elemento de destino
source_element = driver.find_element(By.ID, "source_element_id")
target_element = driver.find_element(By.ID, "target_element_id")

# Crear el objeto ActionChains
actions = ActionChains(driver)

# Operación de arrastrar y soltar
actions.drag_and_drop(source_element, target_element).perform()

# Cerrar el navegador
driver.quit()

Operación de hover

La operación de hover consiste en mantener el puntero del ratón sobre un elemento, generalmente para activar un menú desplegable o mostrar información de ayuda.

Ejemplo

from selenium import webdriver
from selenium.webdriver.chrome.service import Service as ChromeService
from selenium.webdriver.common.action_chains import ActionChains
from selenium.webdriver.common.by import By

# Inicializar el controlador del navegador
driver = webdriver.Chrome()

# Abrir la página web
driver.get("https://example.com")

# Localizar el elemento
element = driver.find_element(By.ID, "element_id")

# Crear el objeto ActionChains
actions = ActionChains(driver)

# Operación de hover
actions.move_to_element(element).perform()

# Cerrar el navegador
driver.quit()

Operaciones de teclado (clase Keys)

En Selenium, las operaciones de teclado se implementan principalmente mediante laKeysclase.KeysLa clase proporciona operaciones de simulación de varias teclas del teclado, incluyendo el envío de combinaciones de teclas y operaciones con teclas especiales.

Enviar combinaciones de teclas

La operación de combinación de teclas consiste en pulsar varias teclas simultáneamente, comoCtrl + C(Copiar) oCtrl + V(Pegar).

Ejemplo

from selenium import webdriver
from selenium.webdriver.chrome.service import Service as ChromeService
from selenium.webdriver.common.keys import Keys
from selenium.webdriver.common.by import By

# Establecer la ruta correcta del controlador
service = ChromeService(executable_path="./chromedriver-mac-arm64/chromedriver")
options = webdriver.ChromeOptions()
driver = webdriver.Chrome(service=service, options=options)

# Abrir la página web
driver.get("https://example.com")

# Localizar el campo de entrada
input_element = driver.find_element(By.ID, "input_element_id")

# Ingresar contenido y enviar combinación de teclas
input_element.send_keys("Hello, World!")
input_element.send_keys(Keys.CONTROL, 'a')  # Seleccionar todo
input_element.send_keys(Keys.CONTROL, 'c')  # Copiar
input_element.send_keys(Keys.CONTROL, 'v')  # Pegar

# Cerrar el navegador
driver.quit()

Operaciones con teclas especiales (Enter, Tab, Shift, etc.)

Las operaciones con teclas especiales consisten en simular la pulsación de teclas especiales del teclado, comoEnter、Tab、Shiftetc.

Ejemplo

from selenium import webdriver
from selenium.webdriver.chrome.service import Service as ChromeService
from selenium.webdriver.common.keys import Keys
from selenium.webdriver.common.by import By

# Establecer la ruta correcta del controlador
service = ChromeService(executable_path="./chromedriver-mac-arm64/chromedriver")
options = webdriver.ChromeOptions()
driver = webdriver.Chrome(service=service, options=options)

# Abrir la página web
driver.get("https://example.com")

# Localizar el campo de entrada
input_element = driver.find_element(By.ID, "input_element_id")

# Ingresar contenido y pulsar la tecla Enter
input_element.send_keys("Hello, World!")
input_element.send_keys(Keys.ENTER)

# Pulsar la tecla Tab para cambiar al siguiente elemento
input_element.send_keys(Keys.TAB)

# Pulsar la tecla Shift e ingresar letras mayúsculas
input_element.send_keys(Keys.SHIFT, "a")  # Ingresar 'A' mayúscula

# Cerrar el navegador
driver.quit()

Ejemplo completo

El siguiente es un ejemplo completo que muestra cómo utilizar las operaciones de ratón y teclado:

Ejemplo

from selenium import webdriver
from selenium.webdriver.chrome.service import Service as ChromeService
from selenium.webdriver.common.by import By
from selenium.webdriver.common.action_chains import ActionChains
from selenium.webdriver.common.keys import Keys

# Establecer la ruta correcta del controlador
service = ChromeService(executable_path="./chromedriver-mac-arm64/chromedriver")
options = webdriver.ChromeOptions()
driver = webdriver.Chrome(service=service, options=options)

# Abrir la página web
driver.get("https://www.example.com")

# Operaciones de ratón
element = driver.find_element(By.ID, "button")
actions = ActionChains(driver)
actions.move_to_element(element).click().perform()

# Operaciones de teclado
input_box = driver.find_element(By.ID, "input-box")
input_box.send_keys("Hello, Selenium!")
input_box.send_keys(Keys.ENTER)

# Cerrar el navegador
driver.quit()
Otras extensiones