browserless 10.9.17 → 10.9.18
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 +37 -6
- package/package.json +16 -13
package/README.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
<div align="center">
|
|
2
|
-
<br>
|
|
3
2
|
<img style="width: 500px; margin:3rem 0 1.5rem;" src="https://github.com/microlinkhq/browserless/raw/master/static/logo-banner.png#gh-light-mode-only" alt="browserless">
|
|
4
3
|
<img style="width: 500px; margin:3rem 0 1.5rem;" src="https://github.com/microlinkhq/browserless/raw/master/static/logo-banner-light.png#gh-dark-mode-only" alt="browserless">
|
|
5
|
-
<br>
|
|
6
|
-
<
|
|
7
|
-
<
|
|
8
|
-
<
|
|
9
|
-
<
|
|
4
|
+
<br><br>
|
|
5
|
+
<a href="https://microlink.io"><img src="https://img.shields.io/badge/powered_by-microlink.io-blue?style=flat-square&color=%23EA407B" alt="Powered by microlink.io"></a>
|
|
6
|
+
<img src="https://img.shields.io/github/tag/microlinkhq/browserless.svg?style=flat-square" alt="Last version">
|
|
7
|
+
<a href="https://coveralls.io/github/microlinkhq/browserless"><img src="https://img.shields.io/coveralls/microlinkhq/browserless.svg?style=flat-square" alt="Coverage Status"></a>
|
|
8
|
+
<a href="https://www.npmjs.org/package/browserless"><img src="https://img.shields.io/npm/dm/browserless.svg?style=flat-square" alt="NPM Status"></a>
|
|
9
|
+
<br><br>
|
|
10
10
|
</div>
|
|
11
11
|
|
|
12
12
|
## Install
|
|
@@ -17,6 +17,37 @@ Using npm:
|
|
|
17
17
|
npm install browserless puppeteer --save
|
|
18
18
|
```
|
|
19
19
|
|
|
20
|
+
## About
|
|
21
|
+
|
|
22
|
+
This is the **core package** of the browserless monorepo. It provides a high-level, performance-oriented API for headless Chrome/Chromium automation built on top of [Puppeteer](https://github.com/puppeteer/puppeteer).
|
|
23
|
+
|
|
24
|
+
### What this package does
|
|
25
|
+
|
|
26
|
+
The `browserless` package serves as the main entry point and orchestrator for the entire browserless ecosystem. It handles:
|
|
27
|
+
|
|
28
|
+
- **Browser process management**: Spawns and manages headless Chrome/Chromium processes with optimized flags for performance and stability. Includes automatic respawning when the browser disconnects.
|
|
29
|
+
|
|
30
|
+
- **Browser context isolation**: Creates isolated browser contexts (similar to browser tabs) with separate cookies and cache, enabling concurrent operations without cross-contamination.
|
|
31
|
+
|
|
32
|
+
- **Built-in methods**: Provides ready-to-use methods for common tasks:
|
|
33
|
+
- `html(url)` – Serialize page content to HTML
|
|
34
|
+
- `text(url)` – Extract plain text from a page
|
|
35
|
+
- `pdf(url)` – Generate PDF documents
|
|
36
|
+
- `screenshot(url)` – Capture screenshots with device emulation and overlay support
|
|
37
|
+
|
|
38
|
+
- **Reliability features**: Built-in retry logic, timeout handling, and graceful error recovery for production environments.
|
|
39
|
+
|
|
40
|
+
### How it fits in the monorepo
|
|
41
|
+
|
|
42
|
+
This package integrates and re-exports functionality from other `@browserless/*` packages:
|
|
43
|
+
|
|
44
|
+
| Dependency | Purpose |
|
|
45
|
+
|------------|---------|
|
|
46
|
+
| `@browserless/goto` | Page navigation with smart waiting strategies, ad blocking, and evasion techniques |
|
|
47
|
+
| `@browserless/screenshot` | Screenshot capture with overlays, device emulation, and code highlighting |
|
|
48
|
+
| `@browserless/pdf` | PDF generation with customizable margins and scaling |
|
|
49
|
+
| `@browserless/errors` | Standardized error handling and timeout errors |
|
|
50
|
+
|
|
20
51
|
## License
|
|
21
52
|
|
|
22
53
|
**browserless** © [Microlink](https://microlink.io), released under the [MIT](https://github.com/microlinkhq/browserless/blob/master/LICENSE.md) License.<br>
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "browserless",
|
|
3
|
-
"description": "The headless Chrome/Chromium
|
|
3
|
+
"description": "The headless Chrome/Chromium driver on top of Puppeteer. Take screenshots, generate PDFs, extract text and HTML with a production-ready API.",
|
|
4
4
|
"homepage": "https://browserless.js.org",
|
|
5
|
-
"version": "10.9.
|
|
5
|
+
"version": "10.9.18",
|
|
6
6
|
"main": "src/index.js",
|
|
7
7
|
"author": {
|
|
8
8
|
"email": "hello@microlink.io",
|
|
@@ -21,20 +21,23 @@
|
|
|
21
21
|
"browser",
|
|
22
22
|
"browserless",
|
|
23
23
|
"chrome",
|
|
24
|
-
"
|
|
25
|
-
"core",
|
|
24
|
+
"chromium",
|
|
26
25
|
"headless",
|
|
27
|
-
"html",
|
|
28
|
-
"pdf",
|
|
29
26
|
"puppeteer",
|
|
30
27
|
"screenshot",
|
|
31
|
-
"
|
|
28
|
+
"pdf",
|
|
29
|
+
"html",
|
|
30
|
+
"text",
|
|
31
|
+
"automation",
|
|
32
|
+
"web-scraping",
|
|
33
|
+
"nodejs",
|
|
34
|
+
"javascript"
|
|
32
35
|
],
|
|
33
36
|
"dependencies": {
|
|
34
|
-
"@browserless/errors": "^10.9.
|
|
35
|
-
"@browserless/goto": "^10.9.
|
|
36
|
-
"@browserless/pdf": "^10.9.
|
|
37
|
-
"@browserless/screenshot": "^10.9.
|
|
37
|
+
"@browserless/errors": "^10.9.18",
|
|
38
|
+
"@browserless/goto": "^10.9.18",
|
|
39
|
+
"@browserless/pdf": "^10.9.18",
|
|
40
|
+
"@browserless/screenshot": "^10.9.18",
|
|
38
41
|
"debug-logfmt": "~1.4.7",
|
|
39
42
|
"kill-process-group": "~1.0.13",
|
|
40
43
|
"p-reflect": "~2.1.0",
|
|
@@ -44,7 +47,7 @@
|
|
|
44
47
|
"superlock": "~1.2.6"
|
|
45
48
|
},
|
|
46
49
|
"devDependencies": {
|
|
47
|
-
"@browserless/test": "^10.9.
|
|
50
|
+
"@browserless/test": "^10.9.18",
|
|
48
51
|
"ava": "5",
|
|
49
52
|
"ps-list": "7",
|
|
50
53
|
"tinyspawn": "latest"
|
|
@@ -64,5 +67,5 @@
|
|
|
64
67
|
"timeout": "2m",
|
|
65
68
|
"workerThreads": false
|
|
66
69
|
},
|
|
67
|
-
"gitHead": "
|
|
70
|
+
"gitHead": "f5e8cd0788e4bad3b3ad9b007943754f96653817"
|
|
68
71
|
}
|