bidi2pdf 0.1.9 → 0.1.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d7fa3c853f53e21a110cadb25fcd66bf97b890eb00663f90e73e8ee9d1ce07e
-  data.tar.gz: 5900568c47f526e9b00d95a15f8293abeaee88f6c0f323bc6e79cdcb3aba38ef
+  metadata.gz: 134f35256652da3e5e6c8e383e97c98779a1e2665798dbfa5d133bc85130b8cc
+  data.tar.gz: dd106af3e757d26ba3d935bbe54d0249402280a84f1b1a8e27855d19b4cd155c
 SHA512:
-  metadata.gz: 9ecffa81a6358c413dd24b1cef48c3b2282518f5934710558b2ea834a362b198d5a1e3f01a2b3eb8ed163dedffaae61fe2bb0c5f3edec5e3850ad375daf10304
-  data.tar.gz: 0b9d4b19f9d2d01a8babfe2a13c4256b9f93d34f2fcdc1ea2942fb780ce4ad02962050f1adffd9d2c5731e2e6c6d1dd83deaa3d31b348157197c982701a8995b
+  metadata.gz: 15d9df827cefb697a44f78945f5fc20866319c7fc6a403f5ad58817f239deca9857fc0923e0a7faf582dac6d7f0770236310cca8bd58aab138ab6499749c6d37
+  data.tar.gz: '09b043e8da1b79a4cc95c708c32afa78b00fa3f6edbedd2e0dacfdd562aff1a385be50f36cc78951a771b1b63c775eac11980dec07d1998476b9b247d6114377'

data/CHANGELOG.md

@@ -1,5 +1,4 @@
 <!-- generated by git-cliff start -->
-
 # Changelog
 
 All notable changes to this project will be documented in this file.
@@ -7,10 +6,65 @@ 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]: https://github.com/dieter-medium/bidi2pdf/compare/v0.1.8..HEAD
+[unreleased]: https://github.com///compare/v0.1.10..HEAD
 
 <!-- generated by git-cliff end -->
 
+## [0.1.10] - 2025-06-18
+
+### 💄 Style
+
+- Improve readability of conditional statements
+
+### 📝 Docs
+
+- Update README with Quick Start section
+- Add Table of Contents and architecture diagram
+- Add high level overview diagram to README
+- Update example URLs in README for clarity
+
+### 🔄 Changed
+
+- Merge pull request #19 from dieter-medium/enhance-docs
+- Merge pull request #18 from dieter-medium/enhance-docs
+- Merge pull request #13 from dieter-medium/dependabot/bundler/main/base64-0.3.0
+- Merge branch 'main' into dependabot/bundler/main/base64-0.3.0
+- Merge pull request #14 from dieter-medium/dependabot/bundler/main/rake-13.3.0
+- Merge branch 'main' into dependabot/bundler/main/rake-13.3.0
+- Merge pull request #12 from dieter-medium/dependabot/bundler/main/rspec-3.13.1
+- Merge pull request #11 from dieter-medium/dependabot/bundler/main/rubocop-1.75.7
+- Merge branch 'main' into dependabot/bundler/main/rubocop-1.75.7
+- Merge pull request #10 from dieter-medium/dependabot/bundler/main/json-2.12.2
+- Merge branch 'main' into dependabot/bundler/main/json-2.12.2
+- Merge pull request #9 from dieter-medium/dependabot/bundler/main/diff-lcs-1.6.2
+- Merge pull request #7 from dieter-medium/dependabot/bundler/main/rubocop-1.75.6
+- Merge pull request #8 from dieter-medium/dependabot/bundler/main/json-2.12.0
+- Merge pull request #6 from dieter-medium/dependabot/bundler/main/rbs-3.9.4
+- Merge pull request #5 from dieter-medium/dependabot/bundler/main/chromedriver-binary-0.1.3
+- Merge pull request #4 from dieter-medium/add-more-default-chrome-args
+- Merge pull request #3 from dieter-medium/make-configuration-rw
+- Merge pull request #2 from dieter-medium/add-test-helpers
+- Merge pull request #1 from dieter-medium/testing-vips
+
+### 🔧 Build
+
+- Bump rspec from 3.13.0 to 3.13.1
+- Bump rake from 13.2.1 to 13.3.0
+- Update base64 requirement from ~> 0.2.0 to >= 0.2, < 0.4
+- Bump rubocop from 1.75.3 to 1.76.2
+- Bump diff-lcs from 1.6.1 to 1.6.2
+- Bump json from 2.10.2 to 2.12.2
+- Bump rbs from 3.9.2 to 3.9.4
+- Bump chromedriver-binary from 0.1.2 to 0.1.3
+
+### 🚀 Added
+
+- Add CDP session handling for PDF generation
+- Expand default Chrome arguments for sessions
+- Add configuration setter for TestHelpers
+- Add test helpers for PDF testing and handling
+- Add image extraction and similarity checking
+
 ## [0.1.9] - 2025-05-04
 
 ### 🎨 Refactored
@@ -200,8 +254,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial release
 
+## Changelog
 
-- [unreleased](https://github.com/dieter-medium/bidi2pdf/compare/v0.1.9..HEAD)
+- [unreleased](https://github.com/dieter-medium/bidi2pdf/compare/v0.1.10..HEAD)
+- [0.1.10](https://github.com/dieter-medium/bidi2pdf/compare/v0.1.9..V0.1.10)
 - [0.1.9](https://github.com/dieter-medium/bidi2pdf/compare/v0.1.8..v0.1.9)
 - [0.1.8](https://github.com/dieter-medium/bidi2pdf/compare/v0.1.7..v0.1.8)
 - [0.1.7](https://github.com/dieter-medium/bidi2pdf/compare/v0.1.6..v0.1.7)

data/README.md

@@ -14,6 +14,23 @@ Bidi2pdf gives you **precision, flexibility, and full control**.
 
 ---
 
+## 📚 Table of Contents
+
+1. [Key Features](#key-features)
+2. [Quick Start](#quick-start)
+3. [Why BiDi?](#why-bidi-instead-of-cdp)
+4. [Installation](#installation)
+5. [CLI Usage](#cli-usage)
+6. [Library API](#library-api)
+7. [Architecture](#architecture)
+8. [Docker](#docker)
+9. [Configuration Options](#configuration-options)
+10. [Rails Integration](#rails-integration)
+11. [Test Helpers](#test-helpers)
+12. [Development](#development)
+13. [Contributing](#contributing)
+14. [License](#license)
+
 ## ✨ Key Features
 
 ✅ **One-liner CLI** – From URL to PDF in a single command  
@@ -27,6 +44,25 @@ Bidi2pdf gives you **precision, flexibility, and full control**.
 
 ---
 
+## ⚡ Quick Start
+
+Get up and running in three easy steps:
+
+```bash
+# 1. Install the gem (system-wide)
+gem install bidi2pdf
+
+# 2. Render any page to PDF
+bidi2pdf render --url https://example.com --output example.pdf
+
+# 3. Open the PDF (macOS shown; use xdg-open on Linux)
+open example.pdf
+```
+
+> **Bundler users** – Add it to your project with `bundle add bidi2pdf`.
+
+---
+
 ## 🚀 Installation
 
 ### Bundler
@@ -54,14 +90,14 @@ gem install bidi2pdf
 ### Command-line
 
 ```bash
-bidi2pdf render --url https://example.com --output example.pdf
+bidi2pdf render --url https://example.com/invoice/14432423 --output example.pdf
 ```
 
 ### Advanced CLI Options
 
 ```bash
 bidi2pdf render \
-  --url https://example.com \
+  --url https://example.com/invoice/14432423 \
   --output example.pdf \
   --cookie session=abc123 \
   --header X-API-KEY=token \
@@ -81,7 +117,7 @@ bidi2pdf render \
 require 'bidi2pdf'
 
 launcher = Bidi2pdf::Launcher.new(
-  url: 'https://example.com',
+  url: 'https://example.com/invoice/14432423',
   output: 'example.pdf',
   cookies: { 'session' => 'abc123' },
   headers: { 'X-API-KEY' => 'token' },
@@ -99,7 +135,7 @@ launcher.launch
 require "bidi2pdf"
 
 Bidi2pdf::DSL.with_tab(headless: true) do |tab|
-  tab.navigate_to("https://example.com")
+  tab.navigate_to("https://example.com/invoice/14432423")
   tab.wait_until_network_idle
   tab.print("example.pdf")
 end
@@ -145,7 +181,7 @@ tab.basic_auth(url_patterns: [{ type: "pattern", protocol: "https", hostname: "e
                username: "username", password: "secret")
 
 # 4. Render PDF
-tab.navigate_to "https://example.com"
+tab.navigate_to "https://example.com/invoice/14432423"
 
 # Alternative: send html code to the browser
 # tab.render_html_content("<html>...</html>")
@@ -176,6 +212,48 @@ session.close
 
 ---
 
+## 🌐 Architecture
+
+```mermaid
+%%{  init: {
+      "theme": "base",
+      "themeVariables": {
+        "primaryColor":  "#E0E7FF",
+        "secondaryColor":"#FEF9C3",
+        "edgeLabelBackground":"#FFFFFF",
+        "fontSize":"14px",
+        "nodeBorderRadius":"6"
+      }
+    }
+}%%
+flowchart LR
+%% ----- Ruby side ---------
+    A["fa:fa-gem Ruby Application"]
+    B["fa:fa-gem bidi2pdf<br/>Library"]
+%% ----Chrome environment -----------
+    subgraph C["fa:fa-chrome Chrome Environment"]
+        direction TB
+        C1["fa:fa-chrome Local Chrome<br/>(sub-process)"]
+        C2["fa:fa-docker Docker Chrome<br/>(remote)"]
+    end
+
+    D[[PDF File]]
+%% ---- Data / control flows ------
+    A -- " HTML / URL + JS / CSS " --> B
+    B -- " WebDriver BiDi " --> C1
+    B -- " WebDriver BiDi " --> C2
+    C1 -- " PDF bytes " --> B
+    C2 -- " PDF bytes " --> B
+    B -- " PDF " --> D
+%% --- Optional extra styling classes (for future tweaks) ---
+    classDef ruby fill:#E0E7FF,stroke:#6366F1,color:#1E1B4B;
+    classDef chrome fill:#FEF9C3,stroke:#F59E0B,color:#78350F;
+    class A,B ruby;
+    class C1,C2 chrome;
+```
+
+---
+
 ## 🐳 Docker Support
 
 ### 🛠️ Build & Run Locally
@@ -191,7 +269,7 @@ docker build -t bidi2pdf -f docker/Dockerfile .
 docker run -it --rm \
   -v ./output:/reports \
   bidi2pdf \
-  bidi2pdf render --url=https://example.com --output /reports/example.pdf
+  bidi2pdf render --url=https://example.com/invoice/14432423 --output /reports/example.pdf
 
 ```
 
@@ -203,7 +281,7 @@ Grab it directly from [Docker Hub](https://hub.docker.com/r/dieters877565/bidi2p
 docker run -it --rm \
   -v ./output:/reports \
   dieters877565/bidi2pdf:main-slim \
-  bidi2pdf render --url=https://example.com --output /reports/example.pdf
+  bidi2pdf render --url=https://example.com/invoice/14432423 --output /reports/example.pdf
 ```
 
 ✅ Tip: Mount your local directory (e.g. ./output) to /reports in the container to easily access the generated PDFs.
@@ -271,6 +349,67 @@ visit: [https://github.com/dieter-medium/bidi2pdf-rails](https://github.com/diet
 
 ---
 
+## 🧪 Test Helpers
+
+Bidi2pdf provides a suite of RSpec helpers (activated with `pdf: true`) to
+simplify PDF-related testing:
+
+### SpecPathsHelper
+
+– `spec_dir` → returns your spec directory  
+– `tmp_dir` → returns your tmp directory  
+– `tmp_file(*parts)` → builds a tmp file path  
+– `random_tmp_dir(*dirs, prefix:)` → builds a random tmp directory
+
+- `fixture_file(*parts)` → returns the path to a fixture file
+
+### PdfFileHelper
+
+– `with_pdf_debug(pdf_data) { |data| … }` → on failure, writes PDF to disk  
+– `store_pdf_file(pdf_data, filename_prefix = "test")` → saves PDF and returns path
+
+### Rspec Matchers
+
+- `have_pdf_page_count` → checks if the PDF has a specific number of pages
+- `match_pdf_text` → checks if the PDF equals a specific text, after stripping whitespace and normalizing characters
+- `contains_pdf_text` → checks if the PDF contains a specific text, after stripping whitespace and normalizing
+  characters, supporting regex
+- `contains_pdf_image` → checks if the PDF contains a specific image
+
+### ChromedriverContainer
+
+`require "bidi2pdf/test_helpers/testcontainers"` you can use the `chromedriver_container` helper to
+start a ChromeDriver container for your tests. This is useful if you don't want to run ChromeDriver locally
+or if you want to ensure a clean environment for your tests.
+
+This also provides the helper methods:
+
+- `session_url` → returns the session URL for the ChromeDriver container
+- `chromedriver_container` → returns the Testcontainers container object
+- `create_session` -> creates a `Bidi2pdf::Bidi::Session` object for the ChromeDriver container
+
+With the environment variable `DISABLE_CHROME_SANDBOX` set to `true`, the container will run Chrome without
+the sandbox. This is useful for CI environments where the sandbox may cause issues.
+
+#### Example
+
+```ruby
+require "bidi2pdf/test_helpers"
+require "bidi2pdf/test_helpers/images" # <= for image matching, requires lib-vips
+require "bidi2pdf/test_helpers/testcontainers" # <= requires testcontainers gem
+
+RSpec.describe "PDF generation", :pdf, :chromedriver do
+  it "generates a PDF with the correct content" do
+    pdf_data = generate_pdf("https://example.com/invoice/14432423")
+    expect(pdf_data).to have_pdf_page_count(1)
+    expect(pdf_data).to match_pdf_text("Hello, world!")
+    expect(pdf_data).to contain_pdf_image(fixture_file("logo.png"))
+  end
+end
+```
+
+---
+
 ## 🛠 Development
 
 ```bash

data/lib/bidi2pdf/bidi/auth_interceptor.rb

@@ -39,6 +39,7 @@ module Bidi2pdf
 
       private
 
+      # rubocop:disable Naming/PredicateMethod
       def handled_bad_credentials(navigation_id, network_id, url)
         return false unless network_ids.include?(network_id)
 
@@ -55,6 +56,8 @@ module Bidi2pdf
 
         true
       end
+
+      # rubocop:enable Naming/PredicateMethod
     end
   end
 end

data/lib/bidi2pdf/bidi/browser_tab.rb

@@ -371,13 +371,13 @@ module Bidi2pdf
       # rubocop:disable Metrics/AbcSize, Metrics/PerceivedComplexity
       def print(outputfile = nil, print_options: { background: true }, &block)
         Bidi2pdf.notification_service.instrument("print.bidi2pdf") do |instrumentation_payload|
-          cmd = Bidi2pdf::Bidi::Commands::BrowsingContextPrint.new context: browsing_context_id, print_options: print_options
+          cmd, extractor = build_command_and_extractor(print_options)
 
           instrumentation_payload[:cmd] = cmd
 
           client.send_cmd_and_wait(cmd) do |response|
             if response["result"]
-              pdf_base64 = response["result"]["data"]
+              pdf_base64 = extractor.call response
 
               instrumentation_payload[:pdf_base64] = pdf_base64
 
@@ -404,6 +404,36 @@ module Bidi2pdf
 
       private
 
+      def build_command_and_extractor(print_options)
+        cmd_type = (print_options.delete(:cmd_type) || :bidi).to_sym
+
+        if cmd_type == :bidi
+          cmd = Bidi2pdf::Bidi::Commands::BrowsingContextPrint.new(
+            context: browsing_context_id,
+            print_options: print_options
+          )
+          extractor = ->(response) { response.dig("result", "data") }
+        else
+          cmd = Bidi2pdf::Bidi::Commands::PagePrint.new(
+            cdp_session: cdp_session,
+            print_options: print_options
+          )
+          extractor = ->(response) { response.dig("result", "result", "data") }
+        end
+
+        [cmd, extractor]
+      end
+
+      def cdp_session
+        @cdp_session ||= begin
+                           cmd = Bidi2pdf::Bidi::Commands::CdpGetSession.new context: browsing_context_id
+                           client.send_cmd_and_wait(cmd) do |response|
+                             Bidi2pdf.logger.debug "CDP session: #{response.inspect}"
+                             response["result"]["session"]
+                           end
+                         end
+      end
+
       def navigate_with_listeners(url)
         register_event_listeners
 
@@ -479,7 +509,7 @@ module Bidi2pdf
             const script = document.createElement('script');
             script.type = 'text/javascript';
 
-            #{content ? "script.text = #{content.to_json};" : ""}
+            #{"script.text = #{content.to_json};" if content}
 
             script.addEventListener(
               'error',
@@ -489,12 +519,12 @@ module Bidi2pdf
               {once: true},
             );
 
-            #{id ? "script.id = '#{id}';" : ""}
+            #{"script.id = '#{id}';" if id}
             #{js_src_part}
 
             document.head.appendChild(script);
 
-            #{url ? "" : "resolve(script);"}
+            #{"resolve(script);" unless url}
           });
         JS
       end
@@ -515,7 +545,7 @@ module Bidi2pdf
               link.type = 'text/css';
               link.href = '#{url}';
             #{"  "}
-              #{id ? "link.id = '#{id}';" : ""}
+              #{"link.id = '#{id}';" if id}
             #{"  "}
               link.addEventListener(
                 'load',
@@ -544,9 +574,9 @@ module Bidi2pdf
                 const style = document.createElement('style');
                 style.type = 'text/css';
             #{"    "}
-                #{id ? "style.id = '#{id}';" : ""}
+                #{"style.id = '#{id}';" if id}
             #{"    "}
-                #{content ? "style.textContent = #{content.to_json};" : ""}
+                #{"style.textContent = #{content.to_json};" if content}
             #{"    "}
                 document.head.appendChild(style);
                 resolve(style);

data/lib/bidi2pdf/bidi/commands/cdp_get_session.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Bidi2pdf
+  module Bidi
+    module Commands
+      class CdpGetSession
+        include Base
+
+        def initialize(context:)
+          @context = context
+        end
+
+        def params = { context: @context }
+
+        def method_name
+          "goog:cdp.getSession"
+        end
+      end
+    end
+  end
+end

data/lib/bidi2pdf/bidi/commands/page_print.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require_relative "print_parameters_validator"
+
+module Bidi2pdf
+  module Bidi
+    module Commands
+      class PagePrint
+        include Base
+
+        def initialize(cdp_session:, print_options:)
+          @cdp_session = cdp_session
+          @print_options = print_options || { background: true }
+
+          PrintParametersValidator.validate!(@print_options)
+
+          return unless @print_options[:page]&.key?(:format)
+
+          @print_options[:page] = Bidi2pdf.translate_paper_format @print_options[:page][:format]
+        end
+
+        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        def params
+          {
+            # https://chromedevtools.github.io/devtools-protocol/tot/Page/#method-printToPDF
+            method: "Page.printToPDF",
+            session: @cdp_session,
+            params: {
+              "printBackground" => @print_options[:background],
+
+              "marginTop" => cm_to_inch(@print_options.dig(:margin, :top) || 0),
+              "marginBottom" => cm_to_inch(@print_options.dig(:margin, :bottom) || 0),
+              "marginLeft" => cm_to_inch(@print_options.dig(:margin, :left) || 0),
+              "marginRight" => cm_to_inch(@print_options.dig(:margin, :right) || 0),
+              "landscape" => (@print_options[:orientation] || "portrait").to_sym == :landscape,
+
+              "paperWidth" => cm_to_inch(@print_options.dig(:page, :width)),
+              "paperHeight" => cm_to_inch(@print_options.dig(:page, :height)),
+              "pageRanges" => page_ranges_to_string(@print_options[:pageRanges]),
+              "scale" => @print_options[:scale] || 1.0,
+
+              "displayHeaderFooter" => @print_options[:display_header_footer],
+              "headerTemplate" => @print_options[:header_template] || "",
+              "footerTemplate" => @print_options[:footer_template] || "",
+
+              "preferCSSPageSize" => @print_options.fetch(:prefer_css_page_size, true),
+
+              "generateTaggedPDF" => @print_options.fetch(:generate_tagged_pdf, false),
+              "generateDocumentOutline" => @print_options.fetch(:generate_document_outline, false),
+
+              transferMode: "ReturnAsBase64"
+            }.compact
+          }
+        end
+
+        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+
+        def method_name
+          "goog:cdp.sendCommand"
+        end
+
+        private
+
+        # rubocop:disable  Naming/MethodParameterName
+        def cm_to_inch(cm)
+          return nil if cm.nil?
+
+          cm.to_f / 2.54
+        end
+
+        # rubocop:enable  Naming/MethodParameterName
+
+        # rubocop:disable Metrics/CyclomaticComplexity
+        def page_ranges_to_string(input)
+          return nil if input.nil? || input.empty?
+
+          segments = input.map do |entry|
+            case entry
+            when Integer
+              entry.to_s
+            when String
+              raise ArgumentError, "Invalid page entry: #{entry.inspect}" unless entry =~ /\A\d+(-\d+)?\z/
+
+              entry
+            else
+              raise ArgumentError, "Unsupported page entry type: #{entry.class}"
+            end
+          end
+
+          # dedupe, sort by numeric start, and join
+          segments
+            .uniq
+            .sort_by { |seg| seg.split("-", 2).first.to_i }
+            .join(",")
+        end
+
+        # rubocop:enable Metrics/CyclomaticComplexity
+      end
+    end
+  end
+end

data/lib/bidi2pdf/bidi/commands/print_parameters_validator.rb

@@ -37,6 +37,7 @@ module Bidi2pdf
           @params = params
         end
 
+        # rubocop:disable Naming/PredicateMethod
         def validate!
           raise ArgumentError, "params must be a Hash" unless @params.is_a?(Hash)
 
@@ -51,6 +52,8 @@ module Bidi2pdf
           true
         end
 
+        # rubocop:enable Naming/PredicateMethod
+
         private
 
         def validate_boolean(key)
@@ -79,7 +82,7 @@ module Bidi2pdf
         def validate_page_ranges
           return unless @params.key?(:pageRanges)
           unless @params[:pageRanges].is_a?(Array) &&
-            @params[:pageRanges].all? { |v| v.is_a?(Integer) || v.is_a?(String) }
+                 @params[:pageRanges].all? { |v| v.is_a?(Integer) || v.is_a?(String) }
             raise ArgumentError, ":pageRanges must be an array of integers or strings"
           end
         end

data/lib/bidi2pdf/bidi/commands.rb

@@ -18,6 +18,8 @@ module Bidi2pdf
       require_relative "commands/browsing_context_close"
       require_relative "commands/browsing_context_navigate"
       require_relative "commands/browsing_context_print"
+      require_relative "commands/cdp_get_session"
+      require_relative "commands/page_print"
       require_relative "commands/session_subscribe"
       require_relative "commands/session_end"
       require_relative "commands/cancel_auth"

data/lib/bidi2pdf/bidi/connection_manager.rb

@@ -17,6 +17,7 @@ module Bidi2pdf
         @connection_latch.count_down
       end
 
+      # rubocop:disable Naming/PredicateMethod
       def wait_until_open(timeout:)
         return true if @connected
 
@@ -26,6 +27,8 @@ module Bidi2pdf
 
         true
       end
+
+      # rubocop:enable Naming/PredicateMethod
     end
   end
 end

data/lib/bidi2pdf/bidi/session.rb

@@ -32,7 +32,38 @@ module Bidi2pdf
       SUBSCRIBE_EVENTS = %w[script].freeze
 
       # Default Chrome arguments for the session.
-      DEFAULT_CHROME_ARGS = %w[--disable-gpu --disable-popup-blocking --disable-hang-monitor].freeze
+      DEFAULT_CHROME_ARGS = [
+        "--allow-pre-commit-input", # Allow pre-commit input for form fields
+        "--disable-dev-shm-usage", # Disable /dev/shm usage; use /tmp instead
+        "--disable-gpu", # Disable GPU hardware acceleration; force software rendering
+        "--disable-popup-blocking", # Allow all pop-ups; bypass built-in popup blocker
+        "--disable-hang-monitor", # Disable “Page Unresponsive” / “Aw, Snap!” dialogs on hangs
+        "--disable-background-networking", # Turn off speculative/periodic network requests (DNS prefetch, Safe Browsing updates, etc.)
+        "--disable-background-timer-throttling", # Prevent JS timers from being throttled in background tabs
+        "--disable-client-side-phishing-detection", # Disable built-in phishing checks; rely only on server-side detection
+        "--disable-component-extensions-with-background-pages", # Block component extensions that run persistent background pages (PDF viewer, Translate, etc.)
+        "--disable-crash-reporter", # Disable crash-report uploads and UI
+        "--disable-default-apps", # Stop installation of Chrome’s default apps on a fresh profile
+        "--disable-infobars", # Suppress “Chrome is being controlled by automated test software” infobar (and similar)
+        "--disable-ipc-flooding-protection", # Turn off defenses against too-many IPC messages from renderers
+        "--disable-prompt-on-repost", # Skip “Confirm Form Resubmission” dialogs on page reloads after POST
+        "--disable-renderer-backgrounding", # Keep background tab renderers at full priority
+        "--disable-search-engine-choice-screen", # Skip first-run search engine selection UI
+        "--disable-sync", # Turn off all Google account sync (bookmarks, passwords, etc.)
+        "--enable-automation", # Expose WebDriver hooks (navigator.webdriver) for automation frameworks
+        "--export-tagged-pdf", # When printing to PDF, include tagged structure for accessibility
+        "--force-color-profile=srgb", # Force rendering to use the sRGB color profile
+        "--generate-pdf-document-outline", # Auto-generate PDF bookmarks/outlines from HTML headings, not supported by chrome/chromium https://issues.chromium.org/issues/41387522#comment48
+        "--metrics-recording-only", # Collect UMA metrics locally but never upload them
+        "--no-first-run", # Skip the “Welcome” or “What’s New” screens on fresh profiles
+        "--password-store=basic", # Use Chrome’s basic (in-profile) password storage vs. OS vault
+        "--use-mock-keychain", # On macOS, use a fake keychain for testing (don’t touch the real one)
+        "--disable-backgrounding-occluded-windows", # Prevent fully-occluded windows from being treated as background
+        "--disable-breakpad", # Disable the Breakpad crash-reporting library entirely
+        "--enable-features=PdfOopif", # Enable out-of-process iframe (OOPIF) architecture for PDF rendering
+        "--disable-features=Translate,AcceptCHFrame,MediaRouter,OptimizationHints,ProcessPerSiteUpToMainFrameThreshold,IsolateSandboxedIframes",
+        "--disable-extensions about:blank"
+      ].freeze
 
       # @return [URI] The URI of the session.
       attr_reader :session_uri
@@ -209,7 +240,7 @@ module Bidi2pdf
       # @return [Hash] The session request payload.
       def session_request
         session_chrome_args = chrome_args.dup
-        session_chrome_args << "--headless" if @headless
+        session_chrome_args << "--headless=new" if @headless
 
         {
           "capabilities" => {