> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cafescraper.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fingerprint Browser

### **🧩 Fingerprint BrowserEnvironment Overview**

To handle **fingerprinting browser and automation detection** on modern websites, the platform **automatically provisions and hosts** an **isolated browser fingerprint environment** during script execution.

This environment is used for operations that require a real browser context, such as **JavaScript rendering, page interaction, login sessions, and authenticated access**.

The fingerprint environment is fully maintained by the platform.\
**Developers do not need to deploy, purchase, or manage fingerprint browser instances** to access a stable and reliable browser runtime.

This mechanism effectively reduces failures and account-linking risks caused by repeated device characteristics or duplicated browser fingerprints.

***

### **📌 Fingerprint Environment Configuration**

* **Browser Type**: Chromium (platform-hosted remote instance)
* **Connection Method**: `WebSocket`
* **Access Endpoint**: Internal platform browser service
* **Authentication**
  * **Environment Variable**: `PROXY_AUTH`
  * **Format**: `username:password`
* **Usage**: Read `PROXY_AUTH` in your script and construct the WebSocket URL to connect
* **Pricing**: **Built-in, no extra cost, no additional setup required**

***

### **🐍 Python Example**

```python theme={null}
try:
    Auth = os.environ.get("PROXY_AUTH")
    CafeSDK.Log.info(f"Current browser auth info: {Auth}")
except Exception as e:
    CafeSDK.Log.error(f"Failed to get browser auth info: {e}")
    Auth = None

# Remote fingerprint browser WebSocket address
browser_url = f'ws://{Auth}@chrome-ws-inner.cafescraper.com'

CafeSDK.Log.info(f"Using remote browser address: {browser_url}")

# ✅ Verify outbound IP via ipinfo
test_url = "https://ipinfo.io/ip"

company_overview = GlassdoorCrawlerCompanyOverview(
    browser_url=browser_url
)

status, soup = await company_overview.fetch_with_playwright(test_url)

# Output result
if soup:
    ip_text = soup.get_text(strip=True)
    CafeSDK.Log.info(f"Current outbound IP: {ip_text}")
else:
    CafeSDK.Log.error("Failed to retrieve page content")

CafeSDK.Log.info(f"Response status code: {status}")
```

***

### **🧱 Go Example**

```go theme={null}
ctx := context.Background()

// Read PROXY_AUTH
auth := os.Getenv("PROXY_AUTH")
CafeSDK.Log.Info(fmt.Sprintf("Current browser auth info: %s", auth))

// Build remote browser WS address
browserURL := "ws://chrome-ws-inner.cafescraper.com"
if auth != "" {
	browserURL = fmt.Sprintf("ws://%s@chrome-ws-inner.cafescraper.com", auth)
}
CafeSDK.Log.Info(ctx, "Using remote browser address: %s", browserURL)

// Start Playwright
pw, err := playwright.Run()
if err != nil {
	CafeSDK.Log.Error(ctx, "Failed to start Playwright: %v", err)
	return
}
defer playwright.Stop()

// Connect to remote fingerprint browser
browser, err := pw.Chromium.ConnectOverCDP(browserURL)
if err != nil {
	CafeSDK.Log.Error(ctx, "Failed to connect to browser: %v", err)
	return
}
defer browser.Close()

// Create page
page, err := browser.NewPage()
if err != nil {
	CafeSDK.Log.Error(ctx, "Failed to create page: %v", err)
	return
}

// Visit ipinfo to verify outbound IP
resp, err := page.Goto("https://ipinfo.io/ip")
if err != nil {
	CafeSDK.Log.Error(ctx, "Page navigation failed: %v", err)
	return
}

page.WaitForLoadState("networkidle")

content, err := page.TextContent("body")
if err != nil {
	CafeSDK.Log.Error(ctx, "Failed to get page content: %v", err)
	return
}

CafeSDK.Log.Info(ctx, "Current outbound IP: %s", content)
CafeSDK.Log.Info(ctx, "Response status code: %d", resp.Status())
```

***

### **🟢 Node.js Example**

```javascript theme={null}
const { chromium } = require('playwright');

(async () => {
  // Read PROXY_AUTH
  const Auth = process.env.PROXY_AUTH;
  console.log('Current browser auth info:', Auth);

  // Build remote browser WS address
  const browserUrl = Auth
    ? `ws://${Auth}@chrome-ws-inner.cafescraper.com`
    : `ws://chrome-ws-inner.cafescraper.com`;

  console.log('Using remote browser address:', browserUrl);

  // Connect to remote fingerprint browser
  const browser = await chromium.connectOverCDP(browserUrl);
  const page = await browser.newPage();

  // Visit ipinfo to verify outbound IP
  const response = await page.goto('https://ipinfo.io/ip', {
    timeout: 60000
  });

  await page.waitForLoadState('networkidle');

  // Read IP
  const ipText = await page.textContent('body');

  console.log('Current outbound IP:', ipText.trim());
  console.log('Response status code:', response.status());

  await browser.close();
})();
```

***

### **⚠️ Notes & Best Practices**

* ❗ **Never hardcode proxy credentials**
* ❗ \*\*Always use the platform-injected \*\*`PROXY_AUTH`**environment variable**
* ✅ The fingerprint browser is **automatically provisioned and rotated** by the platform
* ✅ No manual browser setup or proxy configuration is required