开源项目常见问题解决方案：Apparition

开源项目常见问题解决方案：Apparition

apparition Capybara driver for Chrome using CDP 项目地址: https://gitcode.com/gh_mirrors/ap/apparition

1. 项目基础介绍和主要编程语言

项目名称：Apparition

项目简介：Apparition 是一个为 Capybara 定制的 Chrome 浏览器驱动程序，通过 CDP（Chrome DevTools Protocol）在无头或有头模式下运行。它是 Poltergeist 的一个分支，并尽可能保持与 Poltergeist API 的兼容性。此外，Apparition 还实现了 capybara-webkit 特定的驱动方法。

主要编程语言：Ruby

2. 新手使用项目时需特别注意的问题和解决步骤

问题一：如何在项目中集成 Apparition

问题描述：新手可能不知道如何在项目中添加 Apparition 作为依赖，并正确配置。

解决步骤：

1. 将 gem 'apparition' 或 gem 'apparition', github: 'twalpole/apparition' 添加到你的 Gemfile 中。
2. 运行 bundle install 命令安装依赖。
3. 在你的测试设置中，添加以下代码：

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

问题二：如何处理 Transactional Tests 的问题

问题描述：如果你之前使用的是 :rack_test 驱动，切换到 Apparition 后，应用会在单独的线程中运行，这可能会对事务性测试产生影响。

解决步骤：

1. 确认你的事务性测试是否依赖于共享状态或全局变量。
2. 修改测试，确保它们不依赖于共享状态，或者在测试前后正确地重置状态。
3. 查阅 Capybara 的 README 文档，了解更多关于在不同线程中运行应用的细节。

问题三：如何使用 Apparition 的扩展功能

问题描述：新手可能不知道如何使用 Apparition 提供的额外功能，如截图、设置代理等。

解决步骤：

1. 要截图，使用 save_screenshot('/path/to/file.png') 方法。如果需要截取整个页面，可以添加 full: true 选项。

   save_screenshot('/path/to/file.png', full: true)
   

2. 要设置代理，使用 set_proxy(host, port, type, user, password, bypass: [bypass list]) 方法。

   page.driver.set_proxy('proxy.example.com', 8080, 'http', 'user', 'password', bypass: ['localhost', 'example.com'])
   

3. 查阅项目的 README 文档，了解更多关于这些扩展功能的使用方法。

apparition Capybara driver for Chrome using CDP 项目地址: https://gitcode.com/gh_mirrors/ap/apparition