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ón | Método | Descripción |
|---|---|---|
| Clic | click(element)oclick() | Hace clic en el elemento especificado o en la posición actual del ratón. |
| Doble clic | double_click(element)odouble_click() | Hace doble clic en el elemento especificado o en la posición actual del ratón. |
| Clic derecho | context_click(element)ocontext_click() | Hace clic derecho en el elemento especificado o en la posición actual del ratón. |
| Arrastrar y soltar | drag_and_drop(source, target) | Arrastra el elemento de origen y lo suelta sobre el elemento de destino. |
| Hover | move_to_element(element) | Mueve el ratón sobre el elemento especificado. |
| Mantener presionado y soltar | click_and_hold(element)yrelease() | Mantiene presionado el elemento especificado y lo suelta, utilizado para implementar operaciones de arrastre. |
Operaciones de teclado
| Tipo de operación | Método | Descripción |
|---|---|---|
| Ingresar texto | send_keys("text") | Ingresa el texto especificado en un campo de entrada o área de texto. |
| Pulsar combinación de teclas | send_keys(Keys.CONTROL + 'a') | Simula pulsar una combinación de teclas (como Ctrl + A). |
| Pulsar una tecla individual | send_keys(Keys.KEY_NAME) | Simula pulsar una tecla individual (como Enter, Tab, Shift, etc.). |
| Soltar tecla | key_up(key) | Suelta la tecla pulsada. |
Valores comunes de teclas
| Valor de tecla | Descripción |
|---|---|
Keys.ENTER | Tecla Enter |
Keys.TAB | Tecla Tab |
Keys.SHIFT | Tecla Shift |
Keys.CONTROL | Tecla Ctrl |
Keys.ALT | Tecla Alt |
Keys.ESCAPE | Tecla Esc |
Keys.BACKSPACE | Tecla de retroceso |
Keys.SPACE | Tecla de espacio |
Keys.ARROW_UP | Tecla de flecha hacia arriba |
Keys.ARROW_DOWN | Tecla de flecha hacia abajo |
Keys.ARROW_LEFT | Tecla de flecha hacia la izquierda |
Keys.ARROW_RIGHT | Tecla 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
- Clic (Click): Simula la operación de clic con el botón izquierdo del ratón.
- Doble clic (Double Click): Simula la operación de doble clic con el botón izquierdo del ratón.
- Clic derecho (Right Click): Simula la operación de clic con el botón derecho del ratón.
Ejemplo
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.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.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.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.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.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()