pytest-splinter4 0.3.0

合理的默认值

驱动程序可执行路径参数

使用 chrome、firefox 或 edge 时，executable_path驱动程序参数的默认值设置为也在当前工作目录中搜索 chrome/gecko/edgedriver。

浏览器装置

以下夹具提供了splinter.Browser()的实例

• 浏览器

  splinter 浏览器的新实例。Fixture 是会话范围的，因此每个测试会话都会启动一次浏览器进程，但浏览器的状态将是干净的（当前页面是空白的，cookie 是干净的）。

• session_browser

  除了生命周期外，与浏览器相同。此夹具是会话范围的，因此只会在整个测试会话结束时完成。如果您想通过减少测试隔离来加速您的测试套件支付，这很有用。

• browser_instance_getter

  创建浏览器实例的函数。仅当您需要在单个测试中同时拥有多个浏览器实例时，才需要此夹具。例子：

  @pytest.fixture
  def admin_browser(request, browser_instance_getter):
      """Admin browser fixture."""
      # browser_instance_getter function receives parent fixture -- our admin_browser
      return browser_instance_getter(request, admin_browser)
  
  def test_2_browsers(browser, admin_browser):
      """Test using 2 browsers at the same time."""
      browser.visit('http://google.com')
      admin_browser.visit('http://admin.example.com')

硒夹具

以下夹具提供对 selenium 参数的支持。它们仅在使用基于 Selenium 的驱动程序时使用。

• splinter_selenium_implicit_wait

  隐式等待超时传递给 Selenium webdriver。Fixture 从命令行选项 splinter-implicit-wait 获取值（见下文）

• splinter_selenium_speed

  Selenium 的速度，如果不是 0，那么它将在每个 selenium 命令之间休眠。对调试/演示很有用。Fixture 从命令行选项 splinter-speed 获取值（见下文）

• splinter_selenium_socket_timeout

  webdriver 和浏览器之间通信的套接字超时。Fixture 从命令行选项 splinter-socket-timeout 获取值（见下文）

碎片夹具

以下fixture 提供对splinter 参数的支持。

• splinter_wait_time

  显式等待超时（通过wait_for_condition等待显式条件）。默认值来自命令行选项 splinter-wait-time （见下文）

• splinter_webdriver

  要使用的 Splinter 的 webdriver 名称。默认值来自命令行选项 splinter-webdriver（见下文）。

  要使 pytest-splinter 始终使用某些 webdriver，请覆盖conftest.py文件中的固定装置。例子：

  import pytest
  
  @pytest.fixture(scope='session')
  def splinter_webdriver():
      """Override splinter webdriver name."""
      return 'chrome'

• splinter_remote_url

  要使用的 Webdriver 远程 URL。默认值来自命令行选项 splinter-remote-url（见下文）。

  仅当所选的WebDriver名称为“远程”时，才会使用此情况。

• splinter_remote_name

  运行远程 Webdriver 时使用的浏览器名称。

  This will be used only if the selected webdriver name is 'remote'.

• splinter_session_scoped_browser

  每个测试会话使用一个浏览器实例。默认值来自命令行选项 splinter-session-scoped-browser （见下文）

• splinter_file_download_dir

  目录，浏览器会自动将浏览过程中遇到的文件下载到该目录。例如，当您单击某个下载链接时。默认情况下，它是一个临时目录。目前只有firefox驱动支持自动下载文件。

• splinter_download_file_types

  要自动下载的内容类型的逗号分隔列表。默认情况下，它是所有已知的系统 mime 类型（通过 mimetypes 标准库）。

• splinter_browser_load_condition

  浏览器加载条件，一个应该返回 True 的 python 函数。如果函数返回 False，它将运行多次，直到达到超时。

• splinter_browser_load_timeout

  浏览器加载条件超时（以秒为单位），超时后将引发异常 WaitUntilTimeout。

• splinter_wait_time

  浏览器显式等待超时（以秒为单位），在此超时后将引发异常 WaitUntilTimeout。

• splinter_driver_kwargs

  Webdriver 关键字参数，传递给 selenium webdriver 构造函数的字典（在应用 firefox 首选项后）

  import pytest
  from pathlib import Path
  
  @pytest.fixture
  def splinter_driver_kwargs():
      """
      Webdriver kwargs for Firefox.
      https://selenium-python.readthedocs.io/api.html#module-selenium.webdriver.firefox.webdriver
      """
      return {"service_log_path": Path("/log/directory/geckodriver.log")}

• splinter_window_size

  浏览器初始化时浏览器窗口的大小。表单中的元组 (<width>, <height>)。默认为 (1366, 768)

• splinter_logs_dir

  驱动程序日志目录。默认为“日志”。

• splinter_screenshot_dir

  浏览器截图目录。默认为“日志/{test_function_name}”。

  此夹具从命令行选项 splinter-screenshot-dir获取值（见下文）。

• splinter_make_screenshot_on_failure

  pytest-splinter 是否应该在测试失败时截取浏览器截图？此夹具从命令行选项 splinter-make-screenshot-on-failure获取值（见下文）。

• splinter_screenshot_encoding

  测试失败时对html 屏幕截图的编码。默认为 UTF-8。

• splinter_browser_class

  用于浏览器实例的类。默认为pytest_splinter.plugin.Browser。

• splinter_clean_cookies_urls

  用于清除 cookie 的其他 URL 列表。默认情况下，在为测试准备浏览器期间，pytest-splinter 仅清除上次测试中最后访问的 url 的 cookie，因为按照设计，不可能通过 webdriver 协议一次清除所有域中的所有 cookie。如果您知道 url 列表、需要清除 cookie 的域（例如https://facebook.com），则可以解决此限制。如果是这样，您可以覆盖此固定装置并将这些 url 放在那里，pytest-splinter 将访问它们中的每一个并清除每个域的 cookie。

• splinter_headless

  以无头模式运行 Chrome。默认为假。http://splinter.readthedocs.io/en/latest/drivers/chrome.html#using-headless-option-for-chrome