From ac3c9e6f104d1a1d7bb6b94dc1a200f671a84f73 Mon Sep 17 00:00:00 2001
From: jcgueriaud1 <jean-christophe@vaadin.com>
Date: Fri, 12 Dec 2025 11:00:41 +0200
Subject: [PATCH] Headless feature

---
 README.md                                     |  11 +++++++++++
 pom.xml                                       |  17 ++++++++++++++++-
 src/main/bundles/dev.bundle                   | Bin 850926 -> 850926 bytes
 .../dramafinder/AbstractBasePlaywrightIT.java |  11 +++++++++--
 4 files changed, 36 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 297b85f..7d553a6 100644
--- a/README.md
+++ b/README.md
@@ -105,6 +105,17 @@ To run the integration tests, execute the following command:
 mvn -Pit verify
 ```
 
+To debug the UI with a visible browser, disable headless mode using either the
+`headless` property or the `debug-ui` profile:
+
+```bash
+# system property
+mvn -Dit.test=ContextMenuViewIT -Dheadless=false verify
+
+# convenient profile
+mvn -Pdebug-ui -Dit.test=ContextMenuViewIT verify
+```
+
 ## How to use it
 
 Add the addon as a test dependency.
diff --git a/pom.xml b/pom.xml
index b7cc780..dc5d7c3 100644
--- a/pom.xml
+++ b/pom.xml
@@ -147,10 +147,16 @@
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-surefire-plugin</artifactId>
                 <version>3.2.5</version>
+                <configuration>
+                    <systemPropertyVariables>
+                        <headless>${headless}</headless>
+                    </systemPropertyVariables>
+                </configuration>
             </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-failsafe-plugin</artifactId>
+                <version>3.5.4</version>
                 <executions>
                     <execution>
                         <goals>
@@ -165,6 +171,9 @@
                     </includes>
                     <trimStackTrace>false</trimStackTrace>
                     <enableAssertions>true</enableAssertions>
+                    <systemPropertyVariables>
+                        <headless>${headless}</headless>
+                    </systemPropertyVariables>
                 </configuration>
             </plugin>
             <plugin>
@@ -190,6 +199,12 @@
     </build>
 
     <profiles>
+        <profile>
+            <id>debug-ui</id>
+            <properties>
+                <headless>false</headless>
+            </properties>
+        </profile>
         <profile>
             <id>release</id>
             <build>
@@ -251,4 +266,4 @@
             </build>
         </profile>
     </profiles>
-</project>
\ No newline at end of file
+</project>
diff --git a/src/main/bundles/dev.bundle b/src/main/bundles/dev.bundle
index d470b513e0690da70078f55b15efa43f0d0e2c1c..512c22fc65fb355d4efee63642c3ed13bb42fb88 100644
GIT binary patch
delta 291
zcmaF&-T2*iW8MI7W)=|!4h{|m<*=TKye7;*YNN{vZV)~BJvW%YS&iojBUpf!&l*g7
z^Era(&Ha2TPr(A)K0gD|&GWys&;P;*#7scUynX%`mKw0ib~!UvAZ7z%b|B^eVoo6D
z+Ae3tJ#8;Y>-O!Rx!19RSs6dMEB=94(;t85i2yU~e()H98O1+%Y+xeN)6f3k5eM_0
z!-Um-@>qgJl78~ogBeSH@`QpJe}3{rff<p%ctXI84ZnC2!3>e#P<!%!Lyceeo5ukF
DGO}w$

delta 291
zcmaF&-T2*iW8MI7W)=|!4h{~6&o$i>c}<vs)JB&T+#q`Ldu}j)vl`D6Mz8=cpEa2F
z=5qwmoBR1xo`MCoeSQX_o9BONpZ|psh?#(xdHeh?EHz-2?Q&+UK+Fcj>_E%`#GF9P
zwO!7Pd)i)**6rIrbFX6svod~iSNsF9ra%7969Hz}{opYIGm3xk*uX@jr=R`7BM#<0
zhY73w<go;cB>m*E2Q!xZ<Ou~c{`};L0y83i@q~aG8-DR5f*B&eq4wneh8n-_H;)4V
DsPTj+

diff --git a/src/main/java/org/vaadin/addons/dramafinder/AbstractBasePlaywrightIT.java b/src/main/java/org/vaadin/addons/dramafinder/AbstractBasePlaywrightIT.java
index 21dcbc2..f44fbb6 100644
--- a/src/main/java/org/vaadin/addons/dramafinder/AbstractBasePlaywrightIT.java
+++ b/src/main/java/org/vaadin/addons/dramafinder/AbstractBasePlaywrightIT.java
@@ -105,6 +105,13 @@ protected void select(Locator locator, String val) {
     }
 
     protected static boolean isHeadless() {
-        return true;
+        String propertyValue = System.getProperty("headless");
+        if (propertyValue == null || propertyValue.isBlank()) {
+            propertyValue = System.getenv("HEADLESS");
+        }
+        if (propertyValue == null || propertyValue.isBlank()) {
+            return true;
+        }
+        return Boolean.parseBoolean(propertyValue);
     }
-}
\ No newline at end of file
+}