pytest-splinter4 0.4.0

合理的默认值

驱动程序可执行路径参数

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

浏览器固定值

以下固定值提供 splinter.Browser() 的实例

• browser

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

• session_browser

  与 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 参数的支持。它们仅在基于 Selenium 的驱动程序使用时使用。

• splinter_selenium_implicit_wait

  传递给 Selenium WebDriver 的隐式等待超时。测试用例从命令行选项 splinter-implicit-wait 获取值（见下文）

• splinter_selenium_speed

  Selenium 的速度，如果不为 0，则在每次 Selenium 命令之间将暂停。这对于调试/演示很有用。测试用例从命令行选项 splinter-speed 获取值（见下文）

• splinter_selenium_socket_timeout

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

Splinter 测试用例

以下测试用例提供对 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 名称是‘remote’时使用。

• splinter_remote_name

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

  这仅在选定的 WebDriver 名称是‘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

  驱动程序日志目录。默认为‘logs’。

• splinter_screenshot_dir

  浏览器截图目录。默认为‘logs/{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。如果您知道需要清理cookie的URL列表（例如https://facebook.com），则可以绕过此限制。如果这样做，您可以通过覆盖此固定装置并将这些URL放置其中，pytest-splinter将访问每个URL并为每个域清理cookie。

• splinter_headless

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