Poltergeist 项目使用教程

Poltergeist 项目使用教程

poltergeist A PhantomJS driver for Capybara 项目地址: https://gitcode.com/gh_mirrors/po/poltergeist

1. 项目介绍

Poltergeist 是一个用于 Capybara 的 PhantomJS 驱动程序。它允许你在无头（headless）的 PhantomJS 浏览器上运行 Capybara 测试。如果你希望在无头的 Chrome 浏览器上运行测试，可以使用另一个项目 Cuprite，它声称与 Poltergeist 兼容。

Poltergeist 支持 Capybara 的所有强制性功能，并提供了一些额外的可选功能，如页面截图、网络流量检查、请求头操作等。

2. 项目快速启动

安装

首先，在你的 Gemfile 中添加以下行并运行 bundle install：

gem 'poltergeist'

在你的测试设置中添加以下代码：

require 'capybara/poltergeist'
Capybara.javascript_driver = :poltergeist

安装 PhantomJS

你需要至少 PhantomJS 1.8.1。以下是不同平台的安装方法：

• Mac Homebrew:

  brew tap homebrew/cask && brew cask install phantomjs
  

• MacPorts:

  sudo port install phantomjs
  

• Linux: 下载 32 位或 64 位二进制文件，解压并将其复制到你的 PATH 中。

• Windows: 下载预编译的 Windows 二进制文件。

运行测试

确保你的测试文件中包含以下代码：

require 'capybara/poltergeist'
Capybara.javascript_driver = :poltergeist

然后运行你的测试：

bundle exec rspec

3. 应用案例和最佳实践

应用案例

Poltergeist 常用于需要无头浏览器进行自动化测试的场景。例如，你可以使用它来测试前端 JavaScript 代码的交互效果，或者在 CI/CD 环境中运行集成测试。

最佳实践

1. 使用截图功能：在测试失败时，使用 save_screenshot 方法生成截图，以便更好地调试问题。

   save_screenshot('/path/to/file.png')
   

2. 网络流量检查：使用 page.driver.network_traffic 检查页面加载的资源，帮助诊断网络问题。

   traffic = page.driver.network_traffic
   

3. 请求头操作：在测试中动态设置请求头，模拟不同的用户代理或身份验证。

   page.driver.headers = { "User-Agent" => "Poltergeist" }
   

4. 典型生态项目

Cuprite

Cuprite 是一个基于 Chrome 的无头浏览器驱动程序，与 Poltergeist 兼容。如果你希望在现代浏览器上运行测试，可以考虑使用 Cuprite。

Capybara

Capybara 是一个用于 Web 应用程序的验收测试框架，Poltergeist 是其一个驱动程序。Capybara 支持多种驱动程序，包括 Selenium、Webkit 等。

PhantomJS

PhantomJS 是一个无头浏览器，Poltergeist 依赖于它来运行测试。虽然 PhantomJS 已经停止维护，但它在许多项目中仍然被广泛使用。

通过以上步骤，你可以快速上手并使用 Poltergeist 进行无头浏览器测试。

poltergeist A PhantomJS driver for Capybara 项目地址: https://gitcode.com/gh_mirrors/po/poltergeist