Node

import { launch } from "@heretic-tech/apostate";

const browser = await launch({
  fingerprint: 42,
  fingerprintPlatform: "windows",
  locale: "de-DE",
  timezone: "Europe/Berlin",
});
const page = await browser.newPage();
await page.goto("https://example.com");
console.log(await page.evaluate(() => ({
  platform: navigator.platform,
  languages: navigator.languages,
  timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
})));
await browser.close();

{
  platform: 'Win32',
  languages: [ 'de-DE', 'de', 'en-US', 'en' ],
  timeZone: 'Europe/Berlin'
}

import { launchContext, launchPersistentContext } from "@heretic-tech/apostate";

// The temporary profile's own context. Closing it closes the browser.
const context = await launchContext({ fingerprint: 42, fingerprintPlatform: "windows" });
const page = await context.newPage();
await page.goto("https://example.com");
await context.close();

// A context bound to a directory. Cookies, storage and the machine stay there.
const account = await launchPersistentContext("./profiles/shop-account", { fingerprintPlatform: "windows" });
const accountPage = await account.newPage();
await accountPage.goto("https://example.com");
console.log(await accountPage.evaluate(() => [navigator.hardwareConcurrency, screen.width, screen.height]));
await account.close();

[ 12, 1920, 1080 ]

import { launch } from "@heretic-tech/apostate";

const browser = await launch({
  fingerprint: 42,
  fingerprintPlatform: "windows",
  env: { APOSTATE_DEMO: "1" },              // added to the browser's environment
  ignoreDefaultArgs: ["--hide-scrollbars"], // a switch the driver adds by default
});
const page = await browser.newPage();
await page.setViewportSize({ width: 1280, height: 720 }); // a page-level viewport, if you need one
await browser.close();

{
  proxy: null,
  geoip: 'explicit',
  profile_source: 'native-composed',
  profile_id: 'native-composed',
  profile_identity: null,
  warnings: [],
  catalogue_version: 2,
  chromium_version: '152.0.7977.83'
}

npx apostate run -- --fingerprint=42 --fingerprint-platform=windows --fingerprint-explain

import { driverInfo } from "@heretic-tech/apostate";

console.log(await driverInfo());

{
  preference_order: [
    'patchright',
    'playwright',
    'playwright-core',
    'puppeteer',
    'puppeteer-core'
  ],
  installed: [ 'patchright', 'playwright-core', 'puppeteer-core' ],
  selected: 'patchright',
  recommended: 'patchright'
}

npm install puppeteer-core

import { launch } from "@heretic-tech/apostate";

const browser = await launch({
  driver: "puppeteer-core",
  fingerprint: 42,
  fingerprintPlatform: "windows",
});
const page = await browser.newPage();
await page.goto("https://example.com");
console.log(await page.evaluate(() => ({
  platform: navigator.platform,
  screen: [screen.width, screen.height, screen.availWidth, screen.availHeight],
})));
console.log(browser.apostateDriverName);
await browser.close();

{ platform: 'Win32', screen: [ 1920, 1080, 1920, 1032 ] }
puppeteer-core

import { launchProcess } from "@heretic-tech/apostate";
import puppeteer from "puppeteer-core";

const proc = await launchProcess({
  fingerprint: 42,
  fingerprintPlatform: "windows",
  args: ["--remote-debugging-port=9222"],
});

// Wait for the DevTools endpoint, then connect any CDP client to it.
for (let i = 0; i < 50; i++) {
  try { await fetch("http://127.0.0.1:9222/json/version"); break; }
  catch { await new Promise((resolve) => setTimeout(resolve, 100)); }
}
const browser = await puppeteer.connect({ browserURL: "http://127.0.0.1:9222" });
const [page] = await browser.pages();
await page.goto("https://example.com");
console.log(await page.evaluate(() => navigator.platform));
await browser.disconnect();
await proc.close();

Win32

import { launch } from "@heretic-tech/apostate";

{
  await using browser = await launch({ fingerprint: 42, fingerprintPlatform: "windows" });
  const page = await browser.newPage();
  await page.goto("https://example.com");
} // the browser closes here

import { ApostateError, launch } from "@heretic-tech/apostate";

try {
  const browser = await launch({ fingerprint: 42, args: ["--fingeprint-platform=windows"] });
  await browser.close();
} catch (error) {
  if (!(error instanceof ApostateError)) throw error;
  console.log(error.name, error.code);
  console.log(error.message);
}

ProfileResolutionError APOSTATE_MISSPELLED_FINGERPRINT_SWITCH
--fingeprint-platform is not a switch this browser reads and looks like a typo of --fingerprint-platform; Chromium would ignore it and leave that surface host-inherited