selenium源码通读·5 |webdriver/common/action_chains.py-ActionChains类分析

Posted NoamaNelson

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了selenium源码通读·5 |webdriver/common/action_chains.py-ActionChains类分析相关的知识,希望对你有一定的参考价值。

·5 |webdriver/common/action_chains.py-ActionChains类分析

1 源码路径

selenum/webdriver/common/action_chains.py

2 功能描述

  • 提供鼠标操作,模拟用户的鼠标行为;
  • 如鼠标的各种单击、双击、滑动、拖拽等操作。

3 使用方法

  • 源码说的很清晰了,只要使用以下的方法即可:
  ActionChains can be used in a chain pattern::

        menu = driver.find_element_by_css_selector(".nav")
        hidden_submenu = driver.find_element_by_css_selector(".nav #submenu1")

        ActionChains(driver).move_to_element(menu).click(hidden_submenu).perform()

    Or actions can be queued up one by one, then performed.::

        menu = driver.find_element_by_css_selector(".nav")
        hidden_submenu = driver.find_element_by_css_selector(".nav #submenu1")

        actions = ActionChains(driver)
        actions.move_to_element(menu)
        actions.click(hidden_submenu)
        actions.perform()

4 几个方法

4.1 __init__方法

  • 需要传递一个driver,这个在实际应用中就是使用这个类的时候需要传递一个driver
  • 源码:
 def __init__(self, driver):
        """
        Creates a new ActionChains.

        :Args:
         - driver: The WebDriver instance which performs user actions.
        """
        self._driver = driver
        self._actions = []
        if self._driver.w3c:
            self.w3c_actions = ActionBuilder(driver)

4.2 perform方法

  • 用来执行存储的所有动作或操作;
  • 源码:
    def perform(self):
        """
        Performs all stored actions.
        """
        if self._driver.w3c:
            self.w3c_actions.perform()
        else:
            for action in self._actions:
                action()

4.3 reset_actions方法

  • 用来清空所有的动作;
  • 源码:
    def reset_actions(self):
        """
            Clears actions that are already stored locally and on the remote end
        """
        if self._driver.w3c:
            self.w3c_actions.clear_actions()
        self._actions = []

5 ActionChains类API

API说明
perform(self)执行已经存储的操作
reset_actions(self)清除已存储在本地和远程端的操作
click(self, on_element=None)单击元素,如果元素没有,单击当前鼠标位置
click_and_hold(self, on_element=None)鼠标左键按住某个元素,如果有on_element则点击,如果没有则默认点击鼠标所在位置
context_click(self, on_element=None)右键单击,如果有on_element则点击,如果没有则默认点击鼠标所在位置
double_click(self, on_element=None):鼠标双击,如果有on_element则双击,如果没有则默认点击鼠标所在位置
drag_and_drop(self, source, target)鼠标左键拖拽, 即用鼠标把一个元素拖到另一个元素上
drag_and_drop_by_offset(self, source, xoffset, yoffset)鼠标左键拖拽, 鼠标从源元素拖拽到源元素的x,y轴偏移量上并释放鼠标
key_down(self, value, element=None)按下按键,只应用于修饰健:Control, Alt and Shift
key_up(self, value, element=None)释放按键,只应用于修饰健:Control, Alt and Shift
move_by_offset(self, xoffset, yoffset)鼠标移动,将鼠标移动到当前位置的xy偏移量
move_to_element(self, to_element)鼠标悬停在当前元素上
move_to_element_with_offset(self, to_element, xoffset, yoffset)将鼠标从元素的左上角开始计算开始偏移,偏移量为xy
pause(self, seconds)在指定的持续时间(秒)内暂停所有输入
release(self, on_element=None)在元素上释放鼠标按钮,如果没有元素,则在当前位置释放
send_keys(self, *keys_to_send)在当前位置发送按键 ,键常量在Keys类中
send_keys_to_element(self, element, *keys_to_send)发送按键在当前定位元素上,键常量在Keys类中

6 实例

  • 输入百度网址
  • 输入NoamaNelson
  • 回车搜索
  • 最大化窗口
  • 全选输入的内容,重新输入N
  • 点击“百度一下”进行搜索
# -*- coding:utf-8 -*-
# 作者:NoamaNelson
# 日期:2022/5/16
# 文件名称:selen_stu.py
# 作用:打开百度输入NoamaNelson
# 联系:VX(NoamaNelson)
# 博客:https://blog.csdn.net/NoamaNelson

from selenium import webdriver
from selenium.webdriver.common.keys import Keys
from selenium.webdriver.common.action_chains import ActionChains
import time

driver = webdriver.Chrome()
driver.get("http://www.baidu.com")

driver.find_element_by_id("kw").send_keys("NoamaNelson")
time.sleep(1)
driver.find_element_by_id("kw").send_keys(Keys.ENTER)
driver.maximize_window()
time.sleep(0.5)
driver.find_element_by_id("kw").send_keys(Keys.CONTROL,"a")
time.sleep(0.5)
driver.find_element_by_id("kw").send_keys("N")
su = driver.find_element_by_id("su")
ActionChains(driver).click(su).perform()
time.sleep(1)
driver.quit()

『全栈测试技术,分享,共勉,共进,提升』


以上是关于selenium源码通读·5 |webdriver/common/action_chains.py-ActionChains类分析的主要内容,如果未能解决你的问题,请参考以下文章

selenium源码通读·3 | 从源码看引入webdriver包的原因

selenium源码通读·10 |webdriver/common/proxy.py-Proxy类分析

selenium源码通读·12 |webdriver/remote分析

selenium源码通读·11 |webdriver/common/touch_actions.py-TouchActions类分析

selenium源码通读·12 |webdriver/remote分析

selenium源码通读·13 |webdriver/support分析