@wdio/xvfb 9.19.0 → 9.19.1

package/README.md

@@ -65,7 +65,7 @@ For testing on non-Linux systems:
 ```js
 import { XvfbManager } from "@wdio/xvfb";
 
-const manager = new XvfbManager({ 
+const manager = new XvfbManager({
     force: true,
     xvfbMaxRetries: 3,
     xvfbRetryDelay: 1000
@@ -238,9 +238,10 @@ You can customize xvfb behavior and retry settings:
 export const config = {
     // Xvfb configuration options (all optional)
     autoXvfb: true,              // Enable automatic xvfb (default: true)
+    xvfbAutoInstall: false,      // Enable auto-install of xvfb if missing (default: false)
     xvfbMaxRetries: 5,           // Max retry attempts for xvfb failures (default: 3)
     xvfbRetryDelay: 2000,        // Base delay between retries in ms (default: 1000)
-    
+
     capabilities: [{
         browserName: 'chrome',
         'goog:chromeOptions': {
@@ -253,6 +254,7 @@ export const config = {
 **Configuration Options:**
 
 - **`autoXvfb`** *(boolean, default: true)*: Enable/disable automatic xvfb initialization
+- **`xvfbAutoInstall`** *(boolean, default: false)*: Install `xvfb` packages automatically if `xvfb-run` is missing
 - **`xvfbMaxRetries`** *(number, default: 3)*: Number of retry attempts when xvfb process fails
 - **`xvfbRetryDelay`** *(number, default: 1000)*: Base delay between retries in milliseconds. Uses progressive delay (delay × attempt number)
 

package/build/XvfbManager.d.ts

@@ -12,6 +12,10 @@ export interface XvfbOptions {
      * Skip xvfb-run availability check and force installation (for testing)
      */
     forceInstall?: boolean;
+    /**
+     * Enable automatic installation of Xvfb packages if `xvfb-run` is missing (default: false)
+     */
+    autoInstall?: boolean;
     /**
      * Number of retry attempts for xvfb process failures (default: 3)
      */
@@ -26,6 +30,7 @@ export declare class XvfbManager {
     private force;
     private packageManagerOverride?;
     private forceInstall;
+    private autoInstall;
     private maxRetries;
     private retryDelay;
     private log;

package/build/XvfbManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"XvfbManager.d.ts","sourceRoot":"","sources":["../src/XvfbManager.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,MAAM,WAAW,WAAW;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID,qBAAa,WAAW;IACpB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,sBAAsB,CAAC,CAAQ;IACvC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,GAAG,CAA2B;gBAE1B,OAAO,GAAE,WAAgB;IASrC;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,8BAA8B,GAAG,OAAO;IAoB9E;;;OAGG;IACU,IAAI,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,8BAA8B,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB/F;;OAEG;YACW,sBAAsB;IAsCpC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAI/B;;OAEG;IACH,OAAO,CAAC,oCAAoC;IAO5C;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA0BlC;;OAEG;IACH,OAAO,CAAC,eAAe;cAeP,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;YA4BzC,mBAAmB;IAoCjC;;OAEG;IACU,gBAAgB,CAAC,CAAC,EAC3B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE,MAAyB,GACnC,OAAO,CAAC,CAAC,CAAC;IA2Cb;;OAEG;IACH,OAAO,CAAC,WAAW;CAYtB"}
+{"version":3,"file":"XvfbManager.d.ts","sourceRoot":"","sources":["../src/XvfbManager.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,MAAM,WAAW,WAAW;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID,qBAAa,WAAW;IACpB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,sBAAsB,CAAC,CAAQ;IACvC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,GAAG,CAA2B;gBAE1B,OAAO,GAAE,WAAgB;IAUrC;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,8BAA8B,GAAG,OAAO;IAoB9E;;;OAGG;IACU,IAAI,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,8BAA8B,GAAG,OAAO,CAAC,OAAO,CAAC;IAwB/F;;OAEG;YACW,sBAAsB;IAiDpC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAI/B;;OAEG;IACH,OAAO,CAAC,oCAAoC;IAO5C;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA0BlC;;OAEG;IACH,OAAO,CAAC,eAAe;cAeP,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;YA4BzC,mBAAmB;IAoCjC;;OAEG;IACU,gBAAgB,CAAC,CAAC,EAC3B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE,MAAyB,GACnC,OAAO,CAAC,CAAC,CAAC;IA2Cb;;OAEG;IACH,OAAO,CAAC,WAAW;CAYtB"}

package/build/index.js

@@ -9,6 +9,7 @@ var XvfbManager = class {
   force;
   packageManagerOverride;
   forceInstall;
+  autoInstall;
   maxRetries;
   retryDelay;
   log;
@@ -16,6 +17,7 @@ var XvfbManager = class {
     this.force = options.force ?? false;
     this.packageManagerOverride = options.packageManager;
     this.forceInstall = options.forceInstall ?? false;
+    this.autoInstall = options.autoInstall ?? false;
     this.maxRetries = options.xvfbMaxRetries ?? 3;
     this.retryDelay = options.xvfbRetryDelay ?? 1e3;
     this.log = logger("@wdio/xvfb");
@@ -47,9 +49,13 @@ var XvfbManager = class {
     }
     this.log.info("Xvfb should run, checking if setup is needed");
     try {
-      await this.ensureXvfbRunAvailable();
-      this.log.info("xvfb-run is ready for use");
-      return true;
+      const isReady = await this.ensureXvfbRunAvailable();
+      if (isReady) {
+        this.log.info("xvfb-run is ready for use");
+        return true;
+      }
+      this.log.warn("xvfb-run not available; continuing without virtual display");
+      return false;
     } catch (error) {
       this.log.error("Failed to setup xvfb-run:", error);
       throw error;
@@ -64,9 +70,18 @@ var XvfbManager = class {
       try {
         await execAsync("which xvfb-run");
         this.log.info("xvfb-run found in PATH");
-        return;
+        return true;
       } catch {
-        this.log.info("xvfb-run not found, installing xvfb packages...");
+        if (!this.autoInstall) {
+          this.log.warn(
+            "xvfb-run not found. Skipping automatic installation. To enable auto-install, set 'xvfbAutoInstall: true' in your WDIO config."
+          );
+          this.log.warn(
+            "Hint: you can also install it manually via your distro's package manager (e.g., 'sudo apt-get install xvfb', 'sudo dnf install xorg-x11-server-Xvfb')."
+          );
+          return false;
+        }
+        this.log.info("xvfb-run not found, installing xvfb packages (xvfbAutoInstall enabled)...");
       }
     } else {
       this.log.info("Force install enabled, skipping availability check");
@@ -81,6 +96,7 @@ var XvfbManager = class {
         this.log.info(
           `Successfully installed xvfb-run at: ${stdout.trim()}`
         );
+        return true;
       } catch (error) {
         this.log.error("Failed to install xvfb-run:", error);
         throw new Error(
@@ -88,6 +104,7 @@ var XvfbManager = class {
         );
       }
     }
+    return true;
   }
   /**
    * Detect if headless mode is enabled in Chrome/Chromium capabilities

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wdio/xvfb",
-  "version": "9.19.0",
+  "version": "9.19.1",
   "description": "A standalone utility to manage Xvfb (X Virtual Framebuffer) for headless testing",
   "author": "WebdriverIO Team",
   "homepage": "https://github.com/webdriverio/webdriverio/tree/main/packages/wdio-xvfb",
@@ -44,10 +44,10 @@
   "devDependencies": {
     "@types/is-ci": "^3.0.4",
     "@types/node": "^20.0.0",
-    "@wdio/types": "9.19.0"
+    "@wdio/types": "9.19.1"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "be9a42358a6646d48c3ce5a341761f55aa605b24"
+  "gitHead": "df3ec33741d11d196adad148f4d066a3fcbcd51b"
 }

package/src/XvfbManager.ts

@@ -18,6 +18,10 @@ export interface XvfbOptions {
      * Skip xvfb-run availability check and force installation (for testing)
      */
     forceInstall?: boolean;
+    /**
+     * Enable automatic installation of Xvfb packages if `xvfb-run` is missing (default: false)
+     */
+    autoInstall?: boolean;
     /**
      * Number of retry attempts for xvfb process failures (default: 3)
      */
@@ -35,6 +39,7 @@ export class XvfbManager {
     private force: boolean
     private packageManagerOverride?: string
     private forceInstall: boolean
+    private autoInstall: boolean
     private maxRetries: number
     private retryDelay: number
     private log: ReturnType<typeof logger>
@@ -43,6 +48,7 @@ export class XvfbManager {
         this.force = options.force ?? false
         this.packageManagerOverride = options.packageManager
         this.forceInstall = options.forceInstall ?? false
+        this.autoInstall = options.autoInstall ?? false
         this.maxRetries = options.xvfbMaxRetries ?? 3
         this.retryDelay = options.xvfbRetryDelay ?? 1000
         this.log = logger('@wdio/xvfb')
@@ -85,9 +91,14 @@ export class XvfbManager {
         this.log.info('Xvfb should run, checking if setup is needed')
 
         try {
-            await this.ensureXvfbRunAvailable()
-            this.log.info('xvfb-run is ready for use')
-            return true
+            const isReady = await this.ensureXvfbRunAvailable()
+
+            if (isReady) {
+                this.log.info('xvfb-run is ready for use')
+                return true
+            }
+            this.log.warn('xvfb-run not available; continuing without virtual display')
+            return false
         } catch (error) {
             this.log.error('Failed to setup xvfb-run:', error)
             throw error
@@ -97,7 +108,7 @@ export class XvfbManager {
     /**
      * Ensure xvfb-run is available, installing if necessary
      */
-    private async ensureXvfbRunAvailable(): Promise<void> {
+    private async ensureXvfbRunAvailable(): Promise<boolean> {
         this.log.info('Checking if xvfb-run is available...')
 
         if (!this.forceInstall) {
@@ -105,9 +116,18 @@ export class XvfbManager {
                 // Check if xvfb-run is already available
                 await execAsync('which xvfb-run')
                 this.log.info('xvfb-run found in PATH')
-                return
+                return true
             } catch {
-                this.log.info('xvfb-run not found, installing xvfb packages...')
+                if (!this.autoInstall) {
+                    this.log.warn(
+                        "xvfb-run not found. Skipping automatic installation. To enable auto-install, set 'xvfbAutoInstall: true' in your WDIO config."
+                    )
+                    this.log.warn(
+                        "Hint: you can also install it manually via your distro's package manager (e.g., 'sudo apt-get install xvfb', 'sudo dnf install xorg-x11-server-Xvfb')."
+                    )
+                    return false
+                }
+                this.log.info('xvfb-run not found, installing xvfb packages (xvfbAutoInstall enabled)...')
             }
         } else {
             this.log.info('Force install enabled, skipping availability check')
@@ -126,6 +146,7 @@ export class XvfbManager {
                 this.log.info(
                     `Successfully installed xvfb-run at: ${stdout.trim()}`
                 )
+                return true
             } catch (error) {
                 this.log.error('Failed to install xvfb-run:', error)
                 throw new Error(
@@ -133,6 +154,7 @@ export class XvfbManager {
                 )
             }
         }
+        return true
     }
 
     /**

package/tests/XvfbManager.test.ts

@@ -298,133 +298,161 @@ describe('XvfbManager', () => {
             expect(result).toBe(true)
         })
 
-        it('should install xvfb when xvfb-run is not available', async () => {
-            // Mock xvfb-run not found first, then found after installation
-            mockExecAsync
-                .mockRejectedValueOnce(new Error('Command not found'))
-                .mockResolvedValueOnce({ stdout: '', stderr: '' })
-                .mockResolvedValueOnce({ stdout: '/usr/bin/which', stderr: '' })
-                .mockResolvedValueOnce({ stdout: 'apt-get install success', stderr: '' })
-                .mockResolvedValueOnce({ stdout: '/usr/bin/xvfb-run\n', stderr: '' })
-
-            const manager = new XvfbManager()
-
-            // Mock platform and environment
-            mockPlatform.mockReturnValue('linux')
-            delete process.env.DISPLAY
-
-            const result = await manager.init()
-
-            expect(result).toBe(true)
-            expect(mockExecAsync).toHaveBeenCalledWith('which xvfb-run')
-            expect(mockExecAsync).toHaveBeenCalledWith('which apt-get')
-            expect(mockExecAsync).toHaveBeenCalledWith(
-                'sudo apt-get update -qq && sudo apt-get install -y xvfb',
-                { timeout: 240000 }
-            )
-        })
-    })
-
-    describe('cross-distribution support', () => {
-        beforeEach(() => {
-            mockPlatform.mockReturnValue('linux')
-        })
-
-        it('should detect Ubuntu distribution', async () => {
-            // Mock xvfb-run not found, then package manager detection
-            mockExecAsync
-                .mockRejectedValueOnce(new Error('Command not found'))
-                .mockResolvedValueOnce({ stdout: '/usr/bin/apt-get', stderr: '' })
-                .mockResolvedValueOnce({ stdout: 'installation success', stderr: '' })
-                .mockResolvedValueOnce({ stdout: '/usr/bin/xvfb-run\n', stderr: '' })
-
-            const manager = new XvfbManager()
-            delete process.env.DISPLAY
-
-            await manager.init()
-
-            expect(mockExecAsync).toHaveBeenCalledWith('which apt-get')
-            expect(mockExecAsync).toHaveBeenCalledWith(
-                'sudo apt-get update -qq && sudo apt-get install -y xvfb',
-                { timeout: 240000 }
-            )
-        })
-
-        it('should detect dnf package manager', async () => {
-            // Mock xvfb-run not found, then package manager detection
-            mockExecAsync
-                .mockRejectedValueOnce(new Error('Command not found'))
-                .mockRejectedValueOnce(new Error('apt-get not found'))
-                .mockResolvedValueOnce({ stdout: '/usr/bin/dnf', stderr: '' })
-                .mockResolvedValueOnce({ stdout: 'installation success', stderr: '' })
-                .mockResolvedValueOnce({ stdout: '/usr/bin/xvfb-run\n', stderr: '' })
-
-            const manager = new XvfbManager()
-            delete process.env.DISPLAY
-
-            await manager.init()
-
-            expect(mockExecAsync).toHaveBeenCalledWith('which dnf')
-            expect(mockExecAsync).toHaveBeenCalledWith(
-                'sudo dnf makecache && sudo dnf install -y xorg-x11-server-Xvfb',
-                { timeout: 240000 }
-            )
-        })
-
-        it('should detect pacman package manager', async () => {
-            // Mock xvfb-run not found, then package manager detection
-            mockExecAsync
-                .mockRejectedValueOnce(new Error('Command not found'))
-                .mockRejectedValueOnce(new Error('apt-get not found'))
-                .mockRejectedValueOnce(new Error('dnf not found'))
-                .mockRejectedValueOnce(new Error('yum not found'))
-                .mockRejectedValueOnce(new Error('zypper not found'))
-                .mockResolvedValueOnce({ stdout: '/usr/bin/pacman', stderr: '' })
-                .mockResolvedValueOnce({ stdout: 'installation success', stderr: '' })
-                .mockResolvedValueOnce({ stdout: '/usr/bin/xvfb-run\n', stderr: '' })
-
-            const manager = new XvfbManager()
-            delete process.env.DISPLAY
-
-            await manager.init()
-
-            expect(mockExecAsync).toHaveBeenCalledWith('which pacman')
-            expect(mockExecAsync).toHaveBeenCalledWith(
-                'sudo pacman -Sy --noconfirm xorg-server-xvfb',
-                { timeout: 240000 }
-            )
-        })
-
-        it('should detect dnf when apt-get is not available', async () => {
-            // Mock xvfb-run not found, then package manager detection
-            mockExecAsync
-                .mockRejectedValueOnce(new Error('Command not found'))
-                .mockRejectedValueOnce(new Error('apt-get not found'))
-                .mockResolvedValueOnce({ stdout: '/usr/bin/dnf', stderr: '' })
-                .mockResolvedValueOnce({ stdout: 'installation success', stderr: '' })
-                .mockResolvedValueOnce({ stdout: '/usr/bin/xvfb-run\n', stderr: '' })
-
-            const manager = new XvfbManager()
-            delete process.env.DISPLAY
-
-            await manager.init()
-
-            expect(mockExecAsync).toHaveBeenCalledWith('which apt-get')
-            expect(mockExecAsync).toHaveBeenCalledWith('which dnf')
-        })
-
-        it('should handle unsupported package managers gracefully', async () => {
-            // Mock all package managers as not found
-            mockExecAsync
-                .mockRejectedValueOnce(new Error('Command not found'))
-                .mockRejectedValue(new Error('Package manager not found'))
+        describe('autoInstall', () => {
+            it('should install xvfb when xvfb-run is not available and autoInstall is enabled', async () => {
+                // Mock xvfb-run not found first, then found after installation
+                mockExecAsync
+                    .mockRejectedValueOnce(new Error('Command not found'))
+                    .mockResolvedValueOnce({ stdout: '', stderr: '' })
+                    .mockResolvedValueOnce({ stdout: '/usr/bin/which', stderr: '' })
+                    .mockResolvedValueOnce({ stdout: 'apt-get install success', stderr: '' })
+                    .mockResolvedValueOnce({ stdout: '/usr/bin/xvfb-run\n', stderr: '' })
+
+                const manager = new XvfbManager({ autoInstall: true })
+
+                // Mock platform and environment
+                mockPlatform.mockReturnValue('linux')
+                delete process.env.DISPLAY
+
+                const result = await manager.init()
+
+                expect(result).toBe(true)
+                expect(mockExecAsync).toHaveBeenCalledWith('which xvfb-run')
+                expect(mockExecAsync).toHaveBeenCalledWith('which apt-get')
+                expect(mockExecAsync).toHaveBeenCalledWith(
+                    'sudo apt-get update -qq && sudo apt-get install -y xvfb',
+                    { timeout: 240000 }
+                )
+            })
 
-            const manager = new XvfbManager()
-            delete process.env.DISPLAY
+            it('should not install and return false when xvfb-run is not available and autoInstall is disabled', async () => {
+                // Mock xvfb-run not found
+                mockExecAsync
+                    .mockRejectedValueOnce(new Error('Command not found'))
+
+                const manager = new XvfbManager()
+
+                // Mock platform and environment
+                mockPlatform.mockReturnValue('linux')
+                delete process.env.DISPLAY
+
+                const result = await manager.init()
+
+                expect(result).toBe(false)
+                // Should only check for xvfb-run
+                expect(mockExecAsync).toHaveBeenCalledWith('which xvfb-run')
+                // And should not attempt any package manager detection or install
+                expect(mockExecAsync).not.toHaveBeenCalledWith('which apt-get')
+                expect(mockExecAsync).not.toHaveBeenCalledWith('which dnf')
+                expect(mockExecAsync).not.toHaveBeenCalledWith('which yum')
+                expect(mockExecAsync).not.toHaveBeenCalledWith('which zypper')
+                expect(mockExecAsync).not.toHaveBeenCalledWith('which pacman')
+                expect(mockExecAsync).not.toHaveBeenCalledWith('which apk')
+                expect(mockExecAsync).not.toHaveBeenCalledWith('which xbps-install')
+            })
 
-            await expect(manager.init()).rejects.toThrow(
-                'Unsupported package manager: unknown. Please install Xvfb manually.'
-            )
+            describe('cross-distribution support', () => {
+                beforeEach(() => {
+                    mockPlatform.mockReturnValue('linux')
+                })
+
+                it('should detect Ubuntu distribution', async () => {
+                    // Mock xvfb-run not found, then package manager detection
+                    mockExecAsync
+                        .mockRejectedValueOnce(new Error('Command not found'))
+                        .mockResolvedValueOnce({ stdout: '/usr/bin/apt-get', stderr: '' })
+                        .mockResolvedValueOnce({ stdout: 'installation success', stderr: '' })
+                        .mockResolvedValueOnce({ stdout: '/usr/bin/xvfb-run\n', stderr: '' })
+
+                    const manager = new XvfbManager({ autoInstall: true })
+                    delete process.env.DISPLAY
+
+                    await manager.init()
+
+                    expect(mockExecAsync).toHaveBeenCalledWith('which apt-get')
+                    expect(mockExecAsync).toHaveBeenCalledWith(
+                        'sudo apt-get update -qq && sudo apt-get install -y xvfb',
+                        { timeout: 240000 }
+                    )
+                })
+
+                it('should detect dnf package manager', async () => {
+                    // Mock xvfb-run not found, then package manager detection
+                    mockExecAsync
+                        .mockRejectedValueOnce(new Error('Command not found'))
+                        .mockRejectedValueOnce(new Error('apt-get not found'))
+                        .mockResolvedValueOnce({ stdout: '/usr/bin/dnf', stderr: '' })
+                        .mockResolvedValueOnce({ stdout: 'installation success', stderr: '' })
+                        .mockResolvedValueOnce({ stdout: '/usr/bin/xvfb-run\n', stderr: '' })
+
+                    const manager = new XvfbManager({ autoInstall: true })
+                    delete process.env.DISPLAY
+
+                    await manager.init()
+
+                    expect(mockExecAsync).toHaveBeenCalledWith('which dnf')
+                    expect(mockExecAsync).toHaveBeenCalledWith(
+                        'sudo dnf makecache && sudo dnf install -y xorg-x11-server-Xvfb',
+                        { timeout: 240000 }
+                    )
+                })
+
+                it('should detect pacman package manager', async () => {
+                    // Mock xvfb-run not found, then package manager detection
+                    mockExecAsync
+                        .mockRejectedValueOnce(new Error('Command not found'))
+                        .mockRejectedValueOnce(new Error('apt-get not found'))
+                        .mockRejectedValueOnce(new Error('dnf not found'))
+                        .mockRejectedValueOnce(new Error('yum not found'))
+                        .mockRejectedValueOnce(new Error('zypper not found'))
+                        .mockResolvedValueOnce({ stdout: '/usr/bin/pacman', stderr: '' })
+                        .mockResolvedValueOnce({ stdout: 'installation success', stderr: '' })
+                        .mockResolvedValueOnce({ stdout: '/usr/bin/xvfb-run\n', stderr: '' })
+
+                    const manager = new XvfbManager({ autoInstall: true })
+                    delete process.env.DISPLAY
+
+                    await manager.init()
+
+                    expect(mockExecAsync).toHaveBeenCalledWith('which pacman')
+                    expect(mockExecAsync).toHaveBeenCalledWith(
+                        'sudo pacman -Sy --noconfirm xorg-server-xvfb',
+                        { timeout: 240000 }
+                    )
+                })
+
+                it('should detect dnf when apt-get is not available', async () => {
+                    // Mock xvfb-run not found, then package manager detection
+                    mockExecAsync
+                        .mockRejectedValueOnce(new Error('Command not found'))
+                        .mockRejectedValueOnce(new Error('apt-get not found'))
+                        .mockResolvedValueOnce({ stdout: '/usr/bin/dnf', stderr: '' })
+                        .mockResolvedValueOnce({ stdout: 'installation success', stderr: '' })
+                        .mockResolvedValueOnce({ stdout: '/usr/bin/xvfb-run\n', stderr: '' })
+
+                    const manager = new XvfbManager({ autoInstall: true })
+                    delete process.env.DISPLAY
+
+                    await manager.init()
+
+                    expect(mockExecAsync).toHaveBeenCalledWith('which apt-get')
+                    expect(mockExecAsync).toHaveBeenCalledWith('which dnf')
+                })
+
+                it('should handle unsupported package managers gracefully', async () => {
+                    // Mock all package managers as not found
+                    mockExecAsync
+                        .mockRejectedValueOnce(new Error('Command not found'))
+                        .mockRejectedValue(new Error('Package manager not found'))
+
+                    const manager = new XvfbManager({ autoInstall: true })
+                    delete process.env.DISPLAY
+
+                    await expect(manager.init()).rejects.toThrow(
+                        'Unsupported package manager: unknown. Please install Xvfb manually.'
+                    )
+                })
+            })
         })
     })