feat: add browser launch --args, --user-agent, --proxy-bypass configuration support. (#35)

* feat: add browser launch args, user-agent, and proxy configuration support * fix: User Agent env need added * fix: command pass error --------- Co-authored-by: Chris Tate <chris@ctate.dev>
2026-01-22 00:19:37 -06:00
parent e892bceadf
commit 083a946aac
12 changed files with 1075 additions and 198 deletions
@@ -0,0 +1,158 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { BrowserManager } from '../src/browser.js';
+
+describe('Launch Options', () => {
+  let browser: BrowserManager;
+
+  afterEach(async () => {
+    if (browser?.isLaunched()) {
+      await browser.close();
+    }
+  });
+
+  describe('browser args', () => {
+    it('should launch with custom args to disable webdriver detection', async () => {
+      browser = new BrowserManager();
+      await browser.launch({
+        headless: true,
+        args: ['--disable-blink-features=AutomationControlled'],
+      });
+
+      const page = browser.getPage();
+      await page.goto('about:blank');
+
+      // Check that navigator.webdriver is false
+      const webdriver = await page.evaluate(() => navigator.webdriver);
+      expect(webdriver).toBe(false);
+    });
+
+    it('should launch with multiple args', async () => {
+      browser = new BrowserManager();
+      await browser.launch({
+        headless: true,
+        args: [
+          '--disable-blink-features=AutomationControlled',
+          '--disable-dev-shm-usage',
+        ],
+      });
+
+      expect(browser.isLaunched()).toBe(true);
+    });
+
+    it('should launch without args (default behavior)', async () => {
+      browser = new BrowserManager();
+      await browser.launch({
+        headless: true,
+      });
+
+      const page = browser.getPage();
+      await page.goto('about:blank');
+
+      // Default Playwright behavior - webdriver is true
+      const webdriver = await page.evaluate(() => navigator.webdriver);
+      expect(webdriver).toBe(true);
+    });
+  });
+
+  describe('custom user-agent', () => {
+    it('should launch with custom user-agent', async () => {
+      const customUA = 'CustomTestBot/1.0';
+      browser = new BrowserManager();
+      await browser.launch({
+        headless: true,
+        userAgent: customUA,
+      });
+
+      const page = browser.getPage();
+      await page.goto('about:blank');
+
+      const ua = await page.evaluate(() => navigator.userAgent);
+      expect(ua).toBe(customUA);
+    });
+
+    it('should use default user-agent when not specified', async () => {
+      browser = new BrowserManager();
+      await browser.launch({
+        headless: true,
+      });
+
+      const page = browser.getPage();
+      await page.goto('about:blank');
+
+      const ua = await page.evaluate(() => navigator.userAgent);
+      // Default UA should contain Chrome/Chromium
+      expect(ua).toContain('Chrome');
+    });
+  });
+
+  describe('proxy configuration', () => {
+    it('should accept proxy configuration', async () => {
+      browser = new BrowserManager();
+      // Note: This test just verifies the proxy option is accepted without error
+      // Actual proxy testing requires a running proxy server
+      await browser.launch({
+        headless: true,
+        proxy: {
+          server: 'http://localhost:8080',
+        },
+      });
+
+      expect(browser.isLaunched()).toBe(true);
+    });
+
+    it('should accept proxy with bypass list', async () => {
+      browser = new BrowserManager();
+      await browser.launch({
+        headless: true,
+        proxy: {
+          server: 'http://localhost:8080',
+          bypass: 'localhost,*.internal.com',
+        },
+      });
+
+      expect(browser.isLaunched()).toBe(true);
+    });
+
+    it('should fail connection when proxy is unreachable (proves proxy is being used)', async () => {
+      browser = new BrowserManager();
+      await browser.launch({
+        headless: true,
+        proxy: {
+          server: 'http://127.0.0.1:59999', // Non-existent proxy
+        },
+      });
+
+      const page = browser.getPage();
+      // Navigation should fail because proxy is unreachable
+      // This proves the proxy setting is actually being used
+      await expect(page.goto('https://example.com', { timeout: 5000 })).rejects.toThrow();
+    });
+  });
+
+  describe('combined options', () => {
+    it('should launch with args, user-agent, and proxy combined', async () => {
+      const customUA = 'CombinedTestBot/2.0';
+      browser = new BrowserManager();
+      await browser.launch({
+        headless: true,
+        args: ['--disable-blink-features=AutomationControlled'],
+        userAgent: customUA,
+        proxy: {
+          server: 'http://localhost:8080',
+          bypass: 'localhost',
+        },
+      });
+
+      const page = browser.getPage();
+      await page.goto('about:blank');
+
+      // Verify user-agent
+      const ua = await page.evaluate(() => navigator.userAgent);
+      expect(ua).toBe(customUA);
+
+      // Verify webdriver is hidden
+      const webdriver = await page.evaluate(() => navigator.webdriver);
+      expect(webdriver).toBe(false);
+    });
+  });
+});