capiumbrowser 1.1.7 → 1.1.8

package/lib/config.js

@@ -17,6 +17,42 @@ const fs = require('fs');
 const os = require('os');
 const path = require('path');
 
+// Playwright/Puppeteer default args to SUPPRESS (ignoreDefaultArgs): these leak automation
+// or force a software render.
+//   --enable-automation         : exposes navigator.webdriver=true + an automation banner.
+//   --enable-unsafe-swiftshader : the driver adds this so headless WebGL "works", but it ENABLES
+//                                 the (for us, broken-ICD) bundled SwiftShader path -> getContext
+//                                 ('webgl')=null headless / a software-raster tell. Stripping it
+//                                 forces Chromium onto the real GPU (GPU host) or system Mesa.
+const IGNORE_DEFAULT_ARGS = ['--enable-automation', '--enable-unsafe-swiftshader'];
+
+// Headless default screen/viewport. Headless has no real display, so the per-seed device-pool
+// screen (e.g. 2560x1440) has no window manager to size a matching window against -- the
+// framebuffer would stay at Chromium's small headless default and screen != viewport (a
+// browserscan VM tell). Instead model the single MOST COMMON real setup: a maximized Chrome
+// window on a 1080p Windows monitor -- screen 1920x1080, viewport 1920x947 (1040 avail height
+// minus ~93px of tab/omnibox/bookmark chrome). Dominant real-world viewport, so a headless
+// instance blends in, and screen > viewport stays coherent. Applied only in headless and only
+// when the caller pins no screen (an explicit --fingerprint-screen-* / --window-size opts out).
+const HEADLESS_SCREEN = [1920, 1080];
+const HEADLESS_VIEWPORT = [1920, 947];
+
+function getHeadlessDefaultArgs() {
+  const [sw, sh] = HEADLESS_SCREEN;
+  const [vw, vh] = HEADLESS_VIEWPORT;
+  return [
+    `--fingerprint-screen-width=${sw}`,
+    `--fingerprint-screen-height=${sh}`,
+    `--window-size=${vw},${vh}`,
+  ];
+}
+
+function hasScreenOverride(extra) {
+  if (!Array.isArray(extra)) return false;
+  const keys = ['--window-size', '--fingerprint-screen-width', '--fingerprint-screen-height'];
+  return extra.some((a) => typeof a === 'string' && keys.some((k) => a.startsWith(k)));
+}
+
 /**
  * Return the default per-launch fingerprint flags.
  *
@@ -285,6 +321,11 @@ function findBinary(binary = null) {
 
 module.exports = {
   getDefaultStealthArgs,
+  IGNORE_DEFAULT_ARGS,
+  HEADLESS_SCREEN,
+  HEADLESS_VIEWPORT,
+  getHeadlessDefaultArgs,
+  hasScreenOverride,
   newSeed,
   findBinary,
   searchBases,

package/lib/launch-common.js

@@ -39,9 +39,17 @@ function proxyAndGeoArgs(spec, geoipOn) {
   return { launchOptions, args: out };
 }
 
-function buildArgs({ seed, platform, stealthArgs, timezone, locale, extensionPaths, extra }) {
+function buildArgs({ seed, platform, stealthArgs, timezone, locale, extensionPaths, extra,
+  headless = false }) {
   let args = [];
-  if (stealthArgs) args = args.concat(config.getDefaultStealthArgs(seed, platform));
+  if (stealthArgs) {
+    args = args.concat(config.getDefaultStealthArgs(seed, platform));
+    // Headless: pin the maximized-1080p-Windows screen/viewport (see config), unless the
+    // caller already set their own screen/window via extra args.
+    if (headless && !config.hasScreenOverride(extra)) {
+      args = args.concat(config.getHeadlessDefaultArgs());
+    }
+  }
   if (timezone) args.push(`--timezone=${timezone}`); // capium in-binary tz spoof
   if (locale) {
     args.push(`--lang=${locale}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capiumbrowser",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "Drop-in stealth browser SDK on top of Playwright or Puppeteer (Capium Chromium).",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Capzy (https://capzy.ai)",

package/playwright.js

@@ -78,7 +78,7 @@ async function prepare(opts) {
     seed = null, platform = 'windows', proxy = null, geoip = null, args = null,
     stealthArgs = true, timezone = null, locale = null, extensionPaths = null,
     binary = null, licenseKey = null, licenseServer = null,
-    licenseThroughProxy = false, licensePreflight = true,
+    licenseThroughProxy = false, licensePreflight = true, headless = false,
   } = opts;
   if (licensePreflight) license.preflight(licenseKey, licenseServer);
   const { key } = license.effective(licenseKey, licenseServer);
@@ -87,6 +87,7 @@ async function prepare(opts) {
   const { launchOptions, args: proxyArgs } = proxyAndGeoArgs(proxy, geoip);
   const launchArgs = proxyArgs.concat(buildArgs({
     seed: finalSeed, platform, stealthArgs, timezone, locale, extensionPaths, extra: args,
+    headless,
   }));
   if (licenseThroughProxy) launchArgs.push('--license-through-proxy');
   const env = license.childEnv(licenseKey, licenseServer);
@@ -121,10 +122,11 @@ async function buildLaunchOptions(opts = {}) {
   } = opts;
   const prep = await prepare({
     seed, platform, proxy, geoip, args, stealthArgs, timezone, locale, extensionPaths,
-    binary, licenseKey, licenseServer, licenseThroughProxy, licensePreflight,
+    binary, licenseKey, licenseServer, licenseThroughProxy, licensePreflight, headless,
   });
   return {
     executablePath: prep.binPath, headless, args: prep.launchArgs, env: prep.env,
+    ignoreDefaultArgs: config.IGNORE_DEFAULT_ARGS,   // strip automation + forced-software WebGL defaults
     ...prep.launchOptions, ...rest,
   };
 }
@@ -174,13 +176,14 @@ async function launch(opts = {}) {
   } = opts;
   const prep = await prepare({
     seed, platform, proxy, geoip, args, stealthArgs, timezone, locale, extensionPaths,
-    binary, licenseKey, licenseServer, licenseThroughProxy, licensePreflight,
+    binary, licenseKey, licenseServer, licenseThroughProxy, licensePreflight, headless,
   });
   const pw = requireDriver();
   let browser;
   try {
     browser = await pw.chromium.launch({
       executablePath: prep.binPath, headless, args: prep.launchArgs, env: prep.env,
+      ignoreDefaultArgs: config.IGNORE_DEFAULT_ARGS,   // strip automation + forced-software WebGL defaults
       ...prep.launchOptions, ...rest,
     });
   } catch (e) {
@@ -204,7 +207,7 @@ async function launchPersistentContext(userDataDir, opts = {}) {
   } = opts;
   const prep = await prepare({
     seed, platform, proxy, geoip, args, stealthArgs, timezone, locale, extensionPaths,
-    binary, licenseKey, licenseServer, licenseThroughProxy, licensePreflight,
+    binary, licenseKey, licenseServer, licenseThroughProxy, licensePreflight, headless,
   });
   // Default to the page filling the window (see launchContext) unless the caller pinned a
   // viewport themselves. viewport: null is Playwright-JS for "no fixed viewport".
@@ -214,6 +217,7 @@ async function launchPersistentContext(userDataDir, opts = {}) {
   try {
     ctx = await pw.chromium.launchPersistentContext(userDataDir, {
       executablePath: prep.binPath, headless, args: prep.launchArgs, env: prep.env,
+      ignoreDefaultArgs: config.IGNORE_DEFAULT_ARGS,   // strip automation + forced-software WebGL defaults
       ...prep.launchOptions, ...rest,
     });
   } catch (e) {

package/puppeteer.js

@@ -78,7 +78,7 @@ async function prepare(opts) {
     seed = null, platform = 'windows', proxy = null, geoip = null, args = null,
     stealthArgs = true, timezone = null, locale = null, extensionPaths = null,
     binary = null, licenseKey = null, licenseServer = null,
-    licenseThroughProxy = false, licensePreflight = true,
+    licenseThroughProxy = false, licensePreflight = true, headless = false,
   } = opts;
   if (licensePreflight) license.preflight(licenseKey, licenseServer);
   const { key } = license.effective(licenseKey, licenseServer);
@@ -87,6 +87,7 @@ async function prepare(opts) {
   const { launchOptions, args: proxyArgs } = proxyAndGeoArgs(proxy, geoip);
   const launchArgs = proxyArgs.concat(buildArgs({
     seed: finalSeed, platform, stealthArgs, timezone, locale, extensionPaths, extra: args,
+    headless,
   }));
   if (licenseThroughProxy) launchArgs.push('--license-through-proxy');
   const env = license.childEnv(licenseKey, licenseServer);
@@ -135,7 +136,7 @@ async function buildLaunchOptions(opts = {}) {
   } = opts;
   const prep = await prepare({
     seed, platform, proxy, geoip, args, stealthArgs, timezone, locale, extensionPaths,
-    binary, licenseKey, licenseServer, licenseThroughProxy, licensePreflight,
+    binary, licenseKey, licenseServer, licenseThroughProxy, licensePreflight, headless,
   });
   const proxyOption = prep.launchOptions.proxy || null;
   const launchArgs = [...prep.launchArgs];
@@ -149,7 +150,7 @@ async function buildLaunchOptions(opts = {}) {
     args: launchArgs,
     env: prep.env,
     defaultViewport: 'defaultViewport' in rest ? rest.defaultViewport : null,
-    ignoreDefaultArgs: ignoreDefaultArgs === undefined ? ['--enable-automation'] : ignoreDefaultArgs,
+    ignoreDefaultArgs: ignoreDefaultArgs === undefined ? config.IGNORE_DEFAULT_ARGS : ignoreDefaultArgs,
     ...rest,
   };
 }
@@ -167,7 +168,7 @@ async function launch(opts = {}) {
   } = opts;
   const prep = await prepare({
     seed, platform, proxy, geoip, args, stealthArgs, timezone, locale, extensionPaths,
-    binary, licenseKey, licenseServer, licenseThroughProxy, licensePreflight,
+    binary, licenseKey, licenseServer, licenseThroughProxy, licensePreflight, headless,
   });
   const puppeteer = requireDriver();
   // The CDP escape hatch puts {proxy: {server, username?, ...}} in launchOptions; Puppeteer
@@ -178,8 +179,8 @@ async function launch(opts = {}) {
     launchArgs.push(`--proxy-server=${proxyOption.server}`);
     if (proxyOption.bypass) launchArgs.push(`--proxy-bypass-list=${proxyOption.bypass}`);
   }
-  // Strip Puppeteer's --enable-automation unless the caller took over ignoreDefaultArgs.
-  const ida = ignoreDefaultArgs === undefined ? ['--enable-automation'] : ignoreDefaultArgs;
+  // Strip automation + forced-software WebGL defaults unless the caller took over ignoreDefaultArgs.
+  const ida = ignoreDefaultArgs === undefined ? config.IGNORE_DEFAULT_ARGS : ignoreDefaultArgs;
   let browser;
   try {
     browser = await puppeteer.launch({