cloakbrowser 0.1.4 → 0.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -45,6 +45,8 @@ await browser.close();
|
|
|
45
45
|
|
|
46
46
|
### Puppeteer
|
|
47
47
|
|
|
48
|
+
> **Note:** Playwright is recommended for sites with reCAPTCHA Enterprise. Puppeteer's CDP protocol leaks automation signals that reCAPTCHA Enterprise can detect. This is a known Puppeteer limitation, not specific to CloakBrowser.
|
|
49
|
+
|
|
48
50
|
```javascript
|
|
49
51
|
import { launch } from 'cloakbrowser/puppeteer';
|
|
50
52
|
|
|
@@ -85,7 +87,7 @@ const context = await launchContext({
|
|
|
85
87
|
### Utilities
|
|
86
88
|
|
|
87
89
|
```javascript
|
|
88
|
-
import { ensureBinary, clearCache, binaryInfo } from 'cloakbrowser';
|
|
90
|
+
import { ensureBinary, clearCache, binaryInfo, checkForUpdate } from 'cloakbrowser';
|
|
89
91
|
|
|
90
92
|
// Pre-download binary (e.g., during Docker build)
|
|
91
93
|
await ensureBinary();
|
|
@@ -95,6 +97,10 @@ console.log(binaryInfo());
|
|
|
95
97
|
|
|
96
98
|
// Force re-download
|
|
97
99
|
clearCache();
|
|
100
|
+
|
|
101
|
+
// Manually check for newer Chromium version
|
|
102
|
+
const newVersion = await checkForUpdate();
|
|
103
|
+
if (newVersion) console.log(`Updated to ${newVersion}`);
|
|
98
104
|
```
|
|
99
105
|
|
|
100
106
|
## Test Results
|
|
@@ -115,6 +121,7 @@ clearCache();
|
|
|
115
121
|
| `CLOAKBROWSER_BINARY_PATH` | — | Skip download, use a local Chromium binary |
|
|
116
122
|
| `CLOAKBROWSER_CACHE_DIR` | `~/.cloakbrowser` | Binary cache directory |
|
|
117
123
|
| `CLOAKBROWSER_DOWNLOAD_URL` | GitHub Releases | Custom download URL |
|
|
124
|
+
| `CLOAKBROWSER_AUTO_UPDATE` | `true` | Set to `false` to disable background update checks |
|
|
118
125
|
|
|
119
126
|
## Migrate From Playwright
|
|
120
127
|
|
|
@@ -130,13 +137,17 @@ const page = await browser.newPage();
|
|
|
130
137
|
|
|
131
138
|
## Platforms
|
|
132
139
|
|
|
140
|
+
> **CloakBrowser is in active development.** Pre-built binaries are currently Linux-only. macOS and Windows builds are coming soon.
|
|
141
|
+
|
|
133
142
|
| Platform | Status |
|
|
134
143
|
|---|---|
|
|
135
|
-
| Linux x86_64 | ✅
|
|
144
|
+
| Linux x86_64 | ✅ Available |
|
|
136
145
|
| macOS arm64 (Apple Silicon) | Coming soon |
|
|
137
146
|
| macOS x86_64 (Intel) | Coming soon |
|
|
138
147
|
| Windows | Planned |
|
|
139
148
|
|
|
149
|
+
**On macOS/Windows?** You can still use CloakBrowser via Docker or with your own Chromium binary by setting `CLOAKBROWSER_BINARY_PATH=/path/to/chrome`.
|
|
150
|
+
|
|
140
151
|
## Requirements
|
|
141
152
|
|
|
142
153
|
- Node.js >= 18
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "cloakbrowser",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.5",
|
|
4
4
|
"description": "Stealth Chromium that passes every bot detection test. Drop-in Playwright/Puppeteer replacement with source-level fingerprint patches.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|