Skip to content

Commit 3771285

Browse files
committed
docs: prepare 150.0.7871.127 release documentation
1 parent 7a72d53 commit 3771285

9 files changed

Lines changed: 32 additions & 2 deletions

File tree

CHANGELOG.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,18 @@
33
> **Research scope:** Entries in this changelog describe features evaluated in authorized labs and defensive benchmarking programs. Follow the [Legal Disclaimer](DISCLAIMER.md) and [Responsible Use Guidelines](RESPONSIBLE_USE.md). We work with security vendors to investigate any misuse, so report concerns to [support@botbrowser.io](mailto:support@botbrowser.io).
44
55

6+
## [2026-07-24]
7+
### Major
8+
- **Chromium Core -> 150.0.7871.127**: Updated the BotBrowser 150 release line to 150.0.7871.127. Web Platform consistency, rendering accuracy, and security patches stay aligned with upstream Chrome.
9+
10+
### Improvements
11+
- **Runtime Math Consistency**: Improved profile-backed runtime math behavior across supported host platforms and browser families.
12+
- **Proxy Regional Consistency**: Improved automatic language, locale, and timezone alignment for proxy-backed main and per-context sessions.
13+
- **Per-Context Automation Isolation**: Kept process-level automation bootstrap separate from context-scoped automation across multi-context workflows.
14+
- **Android Target Isolation**: Improved per-context platform behavior for external protocol handling in Android-target sessions.
15+
- **Navigation Stability**: Improved resilience for controlled response and extension-related navigation workflows.
16+
17+
618
## [2026-07-11]
719
### Major
820
- **Chromium Core -> 150.0.7871.46**: Updated the BotBrowser 150 release line to 150.0.7871.46. Web Platform consistency, rendering accuracy, and security patches stay aligned with upstream Chrome.

CLI_FLAGS.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -520,6 +520,8 @@ Execute a JavaScript file right after BotBrowser starts in a privileged, non-ext
520520
--bot-script="/path/to/script.js"
521521
```
522522

523+
At process launch, the script runs once for that browser process. Creating a BrowserContext does not replay it. Pass `--bot-script` explicitly in the context's `botbrowserFlags` when that context needs its own bootstrap.
524+
523525
**Key Features:**
524526
- No framework dependencies: pure Chrome DevTools Protocol access
525527
- Earlier intervention: runs before navigation

PER_CONTEXT_FINGERPRINT.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -351,6 +351,8 @@ Supported live session controls remain available after identity sealing when the
351351

352352
⚠️ Each context can load a completely different profile (`--bot-profile`), or use `--bot-config-*` flags to override specific settings from the browser's base profile.
353353

354+
⚠️ A process-level `--bot-script` runs once at browser startup and is not replayed when new BrowserContexts are created. Pass `--bot-script` explicitly in a context's `botbrowserFlags` when that context needs its own automation bootstrap.
355+
354356
⚠️ Proxy merge semantics are explicit: `--proxy-server` in `botbrowserFlags` sets or replaces the context proxy route, while `--proxy-ip` only supplies the exit IP for geo-detection. If a context was created with `createBrowserContext({ proxyServer })`, a later `setBrowserContextFlags` call with only `--proxy-ip` preserves that proxy route.
355357

356358
⚠️ After identity sealing, dedicated proxy commands may update the route server or bypass rules while preserving the existing proxy IP identity. Changing or clearing `proxyIp` is rejected because it would change geo-derived identity. Create a new BrowserContext when the exit identity must change.

docs/guides/getting-started/BOT_SCRIPT.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,8 @@ That is it. BotBrowser loads the profile, opens a browser window, and executes y
6363

6464
For multi-identity workflows, `--bot-script` can also be passed through Per-Context Fingerprint when creating a BrowserContext. Use this when each context needs its own framework-less automation bootstrap.
6565

66+
The process-level script runs once when BotBrowser starts. Creating additional BrowserContexts does not repeat it. Pass `--bot-script` explicitly when creating a context to run a separate context-scoped bootstrap.
67+
6668
---
6769

6870
<a id="how-it-works"></a>
@@ -140,6 +142,8 @@ const { browserContextId } = await client.send("Target.createBrowserContext", {
140142

141143
Create pages after the context is created so the script and profile are available from the start of the workflow.
142144

145+
Process-level and context-scoped scripts are independent. A process-level script is not inherited by new BrowserContexts.
146+
143147
### Interacting with iframe content
144148

145149
Bot scripts can monitor for embedded iframes and interact with them using CDP input events:

docs/guides/identity/TIMEZONE_LOCALE_LANGUAGE.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -115,6 +115,8 @@ Settings are resolved in this order (highest priority first):
115115
2. **Profile `configs`** (`timezone`, `locale`, `languages` fields in the profile JSON)
116116
3. **Auto-detected** from proxy IP (default behavior)
117117

118+
An `auto` value selects automatic alignment rather than acting as a manual override. Explicit values apply per setting, so the remaining settings can continue to follow the proxy.
119+
118120
---
119121

120122
<a id="common-scenarios"></a>

docs/guides/network/PER_CONTEXT_PROXY.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -118,6 +118,8 @@ const ctxB = await browser.createBrowserContext({
118118
// -> timezone = "Asia/Tokyo"
119119
```
120120

121+
Explicit geographic settings are resolved independently for each context and each setting. Settings left on `auto` continue to derive from that context's proxy.
122+
121123
### Using --proxy-ip to Skip Detection
122124

123125
When you know the exit IP for each proxy, pass it via `--proxy-ip` to skip the auto-detection step. This eliminates the one-time IP lookup overhead per context. The proxy routing set via `createBrowserContext({ proxyServer })` is preserved:

docs/guides/network/PROXY_GEOLOCATION_ALIGNMENT.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,9 @@ This guide focuses on **configuration strategy**:
4444

4545
1. Launch with proxy (`--proxy-server`).
4646
2. BotBrowser derives geographic signals from the proxy exit IP.
47-
3. Optional overrides (`--bot-config-timezone`, `--bot-config-locale`, `--bot-config-languages`) take priority.
47+
3. Explicit CLI or profile `configs` values take priority for the settings they define.
48+
49+
Values set to `auto` keep proxy-based alignment enabled. For example, an explicit locale can remain fixed while timezone and languages continue to follow the proxy.
4850

4951
For internals (lookup pipeline, data source behavior, accuracy boundaries), see [GeoIP Database](GEOIP_DATABASE.md).
5052

docs/guides/platform/ANDROID_EMULATION.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,10 @@ BotBrowser configures all platform-related surfaces to report Android identity:
9797

9898
BotBrowser normalizes the DevTools inspector page zoom and font scaling when debugging Android profiles, keeping the interface readable on desktop.
9999

100+
### External Protocol Isolation
101+
102+
Android-target contexts prevent unsupported external URL schemes from opening applications on the desktop host. Standard web navigation continues normally.
103+
100104
---
101105

102106
<a id="phone-vs-tablet"></a>

profiles/stable/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ BotBrowser 150 profiles are delivered through subscription or support at [suppor
44

55
| Release line | Matching BotBrowser build | Profile files |
66
|--------------|---------------------------|---------------|
7-
| v150 | [150.0.7871.46](https://github.com/botswin/BotBrowser/releases/tag/150.0.7871.46) | Subscription profiles: [support@botbrowser.io](mailto:support@botbrowser.io), [@botbrowser_support](https://t.me/botbrowser_support) |
7+
| v150 | [150.0.7871.127](https://github.com/botswin/BotBrowser/releases/tag/150.0.7871.127) | Subscription profiles: [support@botbrowser.io](mailto:support@botbrowser.io), [@botbrowser_support](https://t.me/botbrowser_support) |
88
| v149 | [149.0.7827.200](https://github.com/botswin/BotBrowser/releases/tag/149.0.7827.200) | Legacy public demo files: `chrome149_*.enc`, `webkit26_*.enc` |
99
| v148 | [148.0.7778.97](https://github.com/botswin/BotBrowser/releases/tag/148.0.7778.97) | Legacy public demo files: `chrome148_*.enc` |
1010

0 commit comments

Comments
 (0)