gstack/browse/test/stealth-extended.test.ts

/**
 * Tests for the opt-in extended stealth mode (#1112 rebased into the
 * v1.41 wave).
 *
 * Pins:
 * 1. Default mode keeps minimum: only WEBDRIVER_MASK_SCRIPT applied.
 * 2. GSTACK_STEALTH=extended adds EXTENDED_STEALTH_SCRIPT on top.
 * 3. EXTENDED_STEALTH_SCRIPT contains the six detection-vector patches.
 * 4. Apply order: default mask first, extended second (so the
 *    delete-from-prototype path layers on top of the getter without
 *    silently overriding it if delete fails).
 *
 * Live SannySoft pass-rate verification is a periodic-tier E2E test
 * (gated behind external network + Chromium); this file pins the
 * static + applyStealth semantics that run on every commit.
 */

import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
import {
  EXTENDED_STEALTH_SCRIPT,
  WEBDRIVER_MASK_SCRIPT,
  isExtendedStealthEnabled,
  applyStealth,
} from '../src/stealth';

let originalEnv: string | undefined;

beforeEach(() => {
  originalEnv = process.env.GSTACK_STEALTH;
});

afterEach(() => {
  if (originalEnv === undefined) delete process.env.GSTACK_STEALTH;
  else process.env.GSTACK_STEALTH = originalEnv;
});

describe('extended stealth — opt-in mode flag', () => {
  test('default mode is OFF (consistency-first contract)', () => {
    delete process.env.GSTACK_STEALTH;
    expect(isExtendedStealthEnabled()).toBe(false);
  });

  test('GSTACK_STEALTH=extended enables extended mode', () => {
    process.env.GSTACK_STEALTH = 'extended';
    expect(isExtendedStealthEnabled()).toBe(true);
  });

  test('GSTACK_STEALTH=1 also enables (env-style boolean)', () => {
    process.env.GSTACK_STEALTH = '1';
    expect(isExtendedStealthEnabled()).toBe(true);
  });

  test('GSTACK_STEALTH=anything-else does NOT enable', () => {
    process.env.GSTACK_STEALTH = 'verbose';
    expect(isExtendedStealthEnabled()).toBe(false);
  });
});

describe('EXTENDED_STEALTH_SCRIPT — six detection-vector patches', () => {
  test('1. deletes navigator.webdriver from prototype', () => {
    expect(EXTENDED_STEALTH_SCRIPT).toMatch(/delete.*Object\.getPrototypeOf\(navigator\)\.webdriver/);
  });

  test('2. spoofs WebGL renderer to Apple M1 Pro', () => {
    expect(EXTENDED_STEALTH_SCRIPT).toContain('Apple M1 Pro');
    expect(EXTENDED_STEALTH_SCRIPT).toContain('UNMASKED_VENDOR_WEBGL');
  });

  test('3. installs PluginArray-prototype-passing navigator.plugins', () => {
    expect(EXTENDED_STEALTH_SCRIPT).toContain('PluginArray');
    expect(EXTENDED_STEALTH_SCRIPT).toContain('MimeType');
  });

  test('4. populates window.chrome with app, runtime, loadTimes, csi', () => {
    expect(EXTENDED_STEALTH_SCRIPT).toContain('chrome.app');
    expect(EXTENDED_STEALTH_SCRIPT).toContain('chrome.runtime');
    expect(EXTENDED_STEALTH_SCRIPT).toContain('chrome.loadTimes');
    expect(EXTENDED_STEALTH_SCRIPT).toContain('chrome.csi');
  });

  test('5. backfills navigator.mediaDevices when missing', () => {
    expect(EXTENDED_STEALTH_SCRIPT).toContain('mediaDevices');
    expect(EXTENDED_STEALTH_SCRIPT).toContain('enumerateDevices');
  });

  test('6. clears CDP cdc_* property names from window', () => {
    expect(EXTENDED_STEALTH_SCRIPT).toContain("startsWith('cdc_')");
  });
});

describe('applyStealth — script wiring', () => {
  test('default mode applies ONLY WEBDRIVER_MASK_SCRIPT', async () => {
    delete process.env.GSTACK_STEALTH;
    const calls: string[] = [];
    const fakeCtx = {
      addInitScript: async (opts: { content: string }) => {
        calls.push(opts.content);
      },
    } as unknown as Parameters<typeof applyStealth>[0];
    await applyStealth(fakeCtx);
    expect(calls).toHaveLength(1);
    expect(calls[0]).toBe(WEBDRIVER_MASK_SCRIPT);
  });

  test('extended mode applies BOTH scripts in order (mask first, extended second)', async () => {
    process.env.GSTACK_STEALTH = 'extended';
    const calls: string[] = [];
    const fakeCtx = {
      addInitScript: async (opts: { content: string }) => {
        calls.push(opts.content);
      },
    } as unknown as Parameters<typeof applyStealth>[0];
    await applyStealth(fakeCtx);
    expect(calls).toHaveLength(2);
    expect(calls[0]).toBe(WEBDRIVER_MASK_SCRIPT);
    expect(calls[1]).toBe(EXTENDED_STEALTH_SCRIPT);
  });
});