chore: release 0.3.2

Author: alec-c4

CHANGELOG.md

@@ -5,49 +5,50 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.3.2] - 2026-02-05
+
+### Fixed
+
+- `Playwright::TargetClosedError` on CI environments without X-server by only enabling debug console in headed mode
+- `pause` now raises a clear error when called in headless mode instead of failing silently
+
 ## [0.3.1] - 2026-02-05
 
 ### Fixed
 
-- **RSpec Integration:** Fixed `uninitialized constant RSpec::Matchers` error when loading the gem in environments where RSpec is only partially initialized (e.g., via `Bundler.require`).
-  - Matchers are now only defined if `RSpec::Matchers` is actually present.
-  - Matchers are no longer automatically loaded by `require "e2e"`; they are now explicitly loaded via `require "e2e/rspec"`.
+- `uninitialized constant RSpec::Matchers` error when loading the gem in environments where RSpec is only partially initialized (e.g., via `Bundler.require`)
+- Matchers are now only defined if `RSpec::Matchers` is actually present
+- Matchers are no longer automatically loaded by `require "e2e"`; they are now explicitly loaded via `require "e2e/rspec"`
 
 ## [0.3.0] - 2026-02-05
 
 ### Added
 
-- **Matchers:** Added custom RSpec matchers:
-  - `have_class("class-name")`
-  - `have_text("content")` / `have_content`
-  - `have_value("val")`
-  - `have_attribute("name", "val")`
-  - `be_visible`
-  - `be_checked`
-  - `be_disabled` / `be_enabled`
-- **Element API:** Added `classes`, `has_class?`, `visible?`, `[]`, `value`, `checked?`, `disabled?`, `enabled?`.
-- **Debugging:** Improved debugging documentation and fixed `pause` helper.
+- Custom RSpec matchers: `have_class`, `have_text`/`have_content`, `have_value`, `have_attribute`, `be_visible`, `be_checked`, `be_disabled`/`be_enabled`
+- Element API methods: `classes`, `has_class?`, `visible?`, `[]`, `value`, `checked?`, `disabled?`, `enabled?`
+- Improved debugging documentation and fixed `pause` helper
 
 ## [0.2.0] - 2026-02-05
 
 ### Added
 
-- **Browser Switching:** Support for Chromium, Firefox, and WebKit via `E2E.config.browser_type`.
-- **Dynamic Session Management:** `E2E.reset_session!` to handle browser switching mid-suite.
-- **Generators:**
-  - `rails g e2e:install` now detects test framework (RSpec/Minitest) and injects RuboCop config.
-  - `rails g e2e:test` scaffolds test files based on the detected framework.
-- **Minitest Support:** Full integration via `E2E::Minitest::TestCase`.
-- **RuboCop Integration:** Automatic injection of `inherit_gem` to relax rules for E2E specs.
-- **Debugging:** `pause` helper for calling Playwright Inspector.
+- Browser switching support for Chromium, Firefox, and WebKit via `E2E.config.browser_type`
+- `E2E.reset_session!` for dynamic session management
+- `rails g e2e:install` generator with test framework detection (RSpec/Minitest) and RuboCop config injection
+- `rails g e2e:test` generator for scaffolding test files
+- Minitest support via `E2E::Minitest::TestCase`
+- RuboCop integration with automatic `inherit_gem` injection
+- `pause` helper for Playwright Inspector
 
 ## [0.1.0] - 2026-02-05
 
 ### Added
 
-- **Core:** Initial release of `e2e` gem, a unified testing framework wrapper around Playwright.
-- **Drivers:** Playwright driver implementation using `playwright-ruby-client` (IPC/Pipes).
-- **DSL:** Capybara-like API including `visit`, `click_button`, `click_link`, `fill_in`, `check`, `uncheck`, `attach_file`, `find`, `all`.
-- **Performance:** `E2E.enable_shared_connection!` for supporting fast transactional tests in Rails.
-- **Rails Integration:** Rack application booting (`E2E.config.app`).
-- **RSpec Support:** Basic RSpec integration (`type: :e2e`).
+- Initial release of `e2e` gem, a unified testing framework wrapper around Playwright
+- Playwright driver implementation using `playwright-ruby-client` (IPC/Pipes)
+- Capybara-like DSL: `visit`, `click_button`, `click_link`, `fill_in`, `check`, `uncheck`, `attach_file`, `find`, `all`
+- `E2E.enable_shared_connection!` for fast transactional tests in Rails
+- Rack application booting via `E2E.config.app`
+- Basic RSpec integration (`type: :e2e`)

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    e2e (0.3.1)
+    e2e (0.3.2)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -148,7 +148,7 @@ CHECKSUMS
   date (3.5.1) sha256=750d06384d7b9c15d562c76291407d89e368dda4d4fff957eb94962d325a0dc0
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
-  e2e (0.3.1)
+  e2e (0.3.2)
   erb (6.0.1) sha256=28ecdd99c5472aebd5674d6061e3c6b0a45c049578b071e5a52c2a7f13c197e5
   io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
   irb (1.16.0) sha256=2abe56c9ac947cdcb2f150572904ba798c1e93c890c256f8429981a7675b0806

README.md

@@ -269,23 +269,27 @@ end
 ```
 
 ### Multiple Browsers
+
 One of the key advantages of Playwright is true cross-browser testing. You can easily switch engines:
 
 - **Chromium:** Google Chrome, Microsoft Edge, etc.
 - **Firefox:** Mozilla Firefox.
 - **WebKit:** Safari, iOS browsers.
 
 To test in Safari (WebKit):
+
 ```ruby
 E2E.configure { |config| config.browser_type = :webkit }
 ```
 
 Don't forget to install all browser binaries:
+
 ```bash
 npx playwright install
 ```
 
 ### Switching Browsers per Test (RSpec)
+
 You can run specific tests in different browsers using metadata (requires simple setup in your helper).
 
 First, update your `spec/e2e_helper.rb` to respect metadata:
@@ -299,7 +303,7 @@ RSpec.configure do |config|
       E2E.reset_session! # Force new browser launch
     end
   end
-  
+
   config.after(:each) do
     if E2E.config.browser_type != :chromium
       E2E.config.browser_type = :chromium

gemfiles/rails_7.0.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    e2e (0.3.1)
+    e2e (0.3.2)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -335,7 +335,7 @@ CHECKSUMS
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  e2e (0.3.1)
+  e2e (0.3.2)
   erb (6.0.1) sha256=28ecdd99c5472aebd5674d6061e3c6b0a45c049578b071e5a52c2a7f13c197e5
   erubi (1.13.1) sha256=a082103b0885dbc5ecf1172fede897f9ebdb745a4b97a5e8dc63953db1ee4ad9
   globalid (1.3.0) sha256=05c639ad6eb4594522a0b07983022f04aa7254626ab69445a0e493aa3786ff11

gemfiles/rails_7.1.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    e2e (0.3.1)
+    e2e (0.3.2)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -349,7 +349,7 @@ CHECKSUMS
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  e2e (0.3.1)
+  e2e (0.3.2)
   erb (6.0.1) sha256=28ecdd99c5472aebd5674d6061e3c6b0a45c049578b071e5a52c2a7f13c197e5
   erubi (1.13.1) sha256=a082103b0885dbc5ecf1172fede897f9ebdb745a4b97a5e8dc63953db1ee4ad9
   globalid (1.3.0) sha256=05c639ad6eb4594522a0b07983022f04aa7254626ab69445a0e493aa3786ff11

gemfiles/rails_7.2.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    e2e (0.3.1)
+    e2e (0.3.2)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -343,7 +343,7 @@ CHECKSUMS
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  e2e (0.3.1)
+  e2e (0.3.2)
   erb (6.0.1) sha256=28ecdd99c5472aebd5674d6061e3c6b0a45c049578b071e5a52c2a7f13c197e5
   erubi (1.13.1) sha256=a082103b0885dbc5ecf1172fede897f9ebdb745a4b97a5e8dc63953db1ee4ad9
   globalid (1.3.0) sha256=05c639ad6eb4594522a0b07983022f04aa7254626ab69445a0e493aa3786ff11

gemfiles/rails_8.0.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    e2e (0.3.1)
+    e2e (0.3.2)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -339,7 +339,7 @@ CHECKSUMS
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  e2e (0.3.1)
+  e2e (0.3.2)
   erb (6.0.1) sha256=28ecdd99c5472aebd5674d6061e3c6b0a45c049578b071e5a52c2a7f13c197e5
   erubi (1.13.1) sha256=a082103b0885dbc5ecf1172fede897f9ebdb745a4b97a5e8dc63953db1ee4ad9
   globalid (1.3.0) sha256=05c639ad6eb4594522a0b07983022f04aa7254626ab69445a0e493aa3786ff11

lib/e2e/drivers/playwright.rb

@@ -12,11 +12,12 @@ def initialize
         browser_type_name = E2E.config.browser_type || :chromium
         @browser_type = @playwright.send(browser_type_name)
 
-        @browser = @browser_type.launch(headless: E2E.config.headless)
+        @headless = E2E.config.headless
+        @browser = @browser_type.launch(headless: @headless)
         @context = @browser.new_context
 
-        # Enable debug console to allow page.pause
-        @context.enable_debug_console!
+        # Enable debug console to allow page.pause (requires GUI, so only in headed mode)
+        @context.enable_debug_console! unless @headless
 
         @page = @context.new_page
       end
@@ -90,6 +91,8 @@ def native
       end
 
       def pause
+        raise E2E::Error, "pause is not available in headless mode" if @headless
+
         @page.pause
       end
 

lib/e2e/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module E2E
-  VERSION = "0.3.1"
+  VERSION = "0.3.2"
 end