feat: support spawnOpts for geckodriver child process

src/index.ts

@@ -9,7 +9,7 @@ import type { GeckodriverParameters } from './types.js'
 const log = logger('geckodriver')
 
 export async function start (params: GeckodriverParameters) {
-  const { cacheDir, customGeckoDriverPath, ...startArgs } = params
+  const { cacheDir, customGeckoDriverPath, spawnOpts, ...startArgs } = params
   let geckoDriverPath = (
     customGeckoDriverPath ||
     process.env.GECKODRIVER_PATH ||
@@ -42,7 +42,7 @@ export async function start (params: GeckodriverParameters) {
 
   const args = parseParams(startArgs)
   log.info(`Starting Geckodriver at ${geckoDriverPath} with params: ${args.join(' ')}`)
-  return cp.spawn(geckoDriverPath, args)
+  return cp.spawn(geckoDriverPath, args, spawnOpts)
 }
 
 export const download = downloadDriver

src/types.ts

@@ -1,5 +1,7 @@
 export type LogLevel = 'fatal' | 'error' | 'warn' | 'info' | 'config' | 'debug' | 'trace'
 
+type SpawnOpt = { [key: string]: string | string[] | SpawnOpt }
+
 export interface GeckodriverParameters {
   /**
    * List of hostnames to allow. By default the value of --host is allowed, and in addition if that's a well
@@ -77,6 +79,8 @@ export interface GeckodriverParameters {
    * @default process.env.GECKODRIVER_CACHE_DIR || os.tmpdir()
    */
   cacheDir?: string
+
+  spawnOpts?: SpawnOpt
 }
 
 declare global {

tests/start-unit.test.ts

@@ -0,0 +1,41 @@
+
+import cp from 'node:child_process'
+import { vi, test, expect } from 'vitest'
+import { type GeckodriverParameters, start } from '../src/index.ts'
+
+test('start', async () => {
+  vi.mock('../src/install.js', () =>  {
+    return {
+      download: vi.fn().mockResolvedValue('foo')
+    }
+  })
+
+  vi.mock('../src/utils.js', async (original) =>  {
+    const actual: any = await original()
+    return {
+      hasAccess: vi.fn().mockResolvedValue(true),
+      parseParams: actual.parseParams
+    }
+  })
+
+  vi.mock('node:child_process', () => ({
+    default: {
+      spawn: vi.fn(),
+    }
+  }))
+
+  const args: GeckodriverParameters  = {
+    spawnOpts: {
+      env: {
+        MOZ_HEADLESS_WIDTH: '720'
+      }
+    }
+  }
+
+  await start(args)
+  expect(cp.spawn).toHaveBeenCalledWith('foo', ['--host=0.0.0.0', '--websocket-port=0'], {
+    env: {
+      MOZ_HEADLESS_WIDTH: '720'
+    }
+  })
+})