Storage and Memory Consistency

BotBrowser provides profile-consistent storage quota and memory values, preventing hardware-based tracking through these APIs.

Prerequisites

• BotBrowser installed. See Installation Guide.
• A profile file (.enc for production).

Quick Start

chromium-browser \
  --bot-profile="/path/to/profile.enc"

Start with this launch to establish a clean baseline before adding extra overrides.

Overview

Storage and memory APIs can expose hardware characteristics that vary per machine, creating a privacy risk. BotBrowser controls these values at the browser engine level, returning profile-consistent responses that match the target device rather than the host machine.

What BotBrowser Controls

Storage Quota

Storage quota values are consistent with the profile’s target hardware, not the actual host disk size.

Heap Memory

Memory-related properties are controlled to return values appropriate for the profile’s target device, with internally consistent relationships between reported values.

Device Memory

Device memory reporting (approximate RAM in gigabytes) is also controlled by the profile, ensuring all memory-related signals are consistent with each other and with the declared hardware.

Common Scenarios

• Capture a baseline result using the Quick Start setup.
• Change one relevant setting at a time and compare the new output.
• Keep your final launch command documented so future checks are reproducible.

Example

import { chromium } from "playwright-core";
 
const browser = await chromium.launch({
  executablePath: process.env.BOTBROWSER_EXEC_PATH,
  headless: true,
  args: [
    `--bot-profile=${process.env.BOT_PROFILE_PATH}`,
  ],
});
 
const page = await browser.newPage();
await page.goto("https://example.com");
 
// ... use the page as needed ...
 
await browser.close();

To verify storage and memory protection is active:

1. Launch BotBrowser with a profile and visit a fingerprint testing site such as BrowserLeaks  or CreepJS .
2. Confirm that the reported storage quota and device memory values match the profile configuration, not the host machine.
3. Launch a second session with the same profile and confirm identical values are reported.

Troubleshooting / FAQ

Next Steps

• CLI Flags Reference. Complete list of all available flags.
• Advanced Features. Technical architecture and implementation details.

Legal Disclaimer & Terms of Use  • Responsible Use Guidelines . BotBrowser is for authorized fingerprint protection and privacy research only.