nothing-browser 0.0.1 → 0.0.2
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 +12 -14
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -7,14 +7,18 @@
|
|
|
7
7
|
|
|
8
8
|
<p align="center">
|
|
9
9
|
<a href="https://www.npmjs.com/package/nothing-browser"><img src="https://img.shields.io/npm/v/nothing-browser" alt="npm version"/></a>
|
|
10
|
-
<a href="LICENSE"><img src="https://img.shields.io/github/license/
|
|
11
|
-
<a href="https://github.com/BunElysiaReact/nothing-browser/releases"><img src="https://img.shields.io/github/v/release/BunElysiaReact/nothing-browser" alt="releases"/></a>
|
|
10
|
+
<a href="LICENSE"><img src="https://img.shields.io/github/license/ernest-tech-house-co-operation/nothing-browser" alt="license"/></a>
|
|
11
|
+
<a href="https://github.com/BunElysiaReact/nothing-browser/releases"><img src="https://img.shields.io/github/v/release/BunElysiaReact/nothing-browser" alt="binary releases"/></a>
|
|
12
12
|
</p>
|
|
13
13
|
|
|
14
14
|
---
|
|
15
15
|
|
|
16
16
|
A scraper-first headless browser library powered by the Nothing Browser Qt6/Chromium engine. Control real browser tabs, intercept network traffic, spoof fingerprints, capture WebSockets — all from Bun + TypeScript.
|
|
17
17
|
|
|
18
|
+
> **Two repos:**
|
|
19
|
+
> - This package (npm lib) → [ernest-tech-house-co-operation/nothing-browser](https://github.com/ernest-tech-house-co-operation/nothing-browser)
|
|
20
|
+
> - Headless binary → [BunElysiaReact/nothing-browser](https://github.com/BunElysiaReact/nothing-browser/releases)
|
|
21
|
+
|
|
18
22
|
---
|
|
19
23
|
|
|
20
24
|
## Requirements
|
|
@@ -30,7 +34,7 @@ A scraper-first headless browser library powered by the Nothing Browser Qt6/Chro
|
|
|
30
34
|
bun add nothing-browser
|
|
31
35
|
```
|
|
32
36
|
|
|
33
|
-
Then download the **headless binary** for your platform from [
|
|
37
|
+
Then download the **headless binary** for your platform from [BunElysiaReact/nothing-browser releases](https://github.com/BunElysiaReact/nothing-browser/releases) and place it in your project root.
|
|
34
38
|
|
|
35
39
|
**Linux**
|
|
36
40
|
```bash
|
|
@@ -96,7 +100,6 @@ import piggy from "nothing-browser";
|
|
|
96
100
|
await piggy.launch({ mode: "tab" });
|
|
97
101
|
await piggy.register("books", "https://books.toscrape.com");
|
|
98
102
|
|
|
99
|
-
// Block ads/trackers before any navigation
|
|
100
103
|
await piggy.books.intercept.block("*google-analytics*");
|
|
101
104
|
await piggy.books.intercept.block("*doubleclick*");
|
|
102
105
|
await piggy.books.intercept.block("*facebook*");
|
|
@@ -222,8 +225,6 @@ process.on("SIGINT", async () => {
|
|
|
222
225
|
|
|
223
226
|
### Human mode
|
|
224
227
|
|
|
225
|
-
Makes interactions look less robotic — random delays, simulated typos + self-correction.
|
|
226
|
-
|
|
227
228
|
```ts
|
|
228
229
|
piggy.actHuman(true);
|
|
229
230
|
|
|
@@ -239,11 +240,10 @@ Affects: `click`, `type`, `hover`, `scroll.by`, `wait`.
|
|
|
239
240
|
### Screenshot / PDF
|
|
240
241
|
|
|
241
242
|
```ts
|
|
242
|
-
// Save to disk
|
|
243
243
|
await piggy.books.screenshot("./out/page.png");
|
|
244
244
|
await piggy.books.pdf("./out/page.pdf");
|
|
245
245
|
|
|
246
|
-
//
|
|
246
|
+
// or base64
|
|
247
247
|
const b64 = await piggy.books.screenshot();
|
|
248
248
|
```
|
|
249
249
|
|
|
@@ -255,10 +255,8 @@ const b64 = await piggy.books.screenshot();
|
|
|
255
255
|
await piggy.register("site1", "https://example.com");
|
|
256
256
|
await piggy.register("site2", "https://example.org");
|
|
257
257
|
|
|
258
|
-
// Same method on both sites in parallel
|
|
259
258
|
const titles = await piggy.all([piggy.site1, piggy.site2]).title();
|
|
260
259
|
|
|
261
|
-
// Keyed results by site name
|
|
262
260
|
const h1s = await piggy.diff([piggy.site1, piggy.site2]).fetchText("h1");
|
|
263
261
|
// → { site1: "...", site2: "..." }
|
|
264
262
|
```
|
|
@@ -274,7 +272,7 @@ const h1s = await piggy.diff([piggy.site1, piggy.site2]).fetchText("h1");
|
|
|
274
272
|
| `mode` | `"tab" \| "process"` | `"tab"` |
|
|
275
273
|
|
|
276
274
|
### `piggy.register(name, url)`
|
|
277
|
-
Registers a site. Accessible as `piggy.<
|
|
275
|
+
Registers a site. Accessible as `piggy.<n>` after registration.
|
|
278
276
|
|
|
279
277
|
### `piggy.actHuman(enable)`
|
|
280
278
|
Toggles human-like interaction timing globally.
|
|
@@ -351,7 +349,7 @@ site.api(path, handler, opts?)
|
|
|
351
349
|
// opts: { ttl?, method?, before?: middleware[] }
|
|
352
350
|
// handler: (params, query, body) => Promise<any>
|
|
353
351
|
|
|
354
|
-
site.noclose()
|
|
352
|
+
site.noclose()
|
|
355
353
|
site.screenshot(filePath?) / site.pdf(filePath?)
|
|
356
354
|
```
|
|
357
355
|
|
|
@@ -366,10 +364,10 @@ site.screenshot(filePath?) / site.pdf(filePath?)
|
|
|
366
364
|
| Windows x64 | `nothing-browser-headless-*.zip` |
|
|
367
365
|
| macOS | `nothing-browser-headless-*.tar.gz` |
|
|
368
366
|
|
|
369
|
-
→ [
|
|
367
|
+
→ [BunElysiaReact/nothing-browser releases](https://github.com/BunElysiaReact/nothing-browser/releases)
|
|
370
368
|
|
|
371
369
|
---
|
|
372
370
|
|
|
373
371
|
## License
|
|
374
372
|
|
|
375
|
-
MIT © [Ernest Tech House](https://github.com/
|
|
373
|
+
MIT © [Ernest Tech House](https://github.com/ernest-tech-house-co-operation)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nothing-browser",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.2",
|
|
4
4
|
"description": "Scraper-first headless browser library — control real tabs, intercept network traffic, capture WebSockets, spoof fingerprints. Powered by Qt6/Chromium.",
|
|
5
5
|
"module": "piggy.ts",
|
|
6
6
|
"main": "piggy.ts",
|
|
@@ -24,15 +24,15 @@
|
|
|
24
24
|
"fingerprint-spoofing",
|
|
25
25
|
"network-interception"
|
|
26
26
|
],
|
|
27
|
-
"author": "Ernest Tech House
|
|
27
|
+
"author": "Ernest Tech House",
|
|
28
28
|
"license": "MIT",
|
|
29
|
-
"homepage": "https://github.com/
|
|
29
|
+
"homepage": "https://github.com/ernest-tech-house-co-operation/nothing-browser#readme",
|
|
30
30
|
"repository": {
|
|
31
31
|
"type": "git",
|
|
32
|
-
"url": "https://github.com/
|
|
32
|
+
"url": "https://github.com/ernest-tech-house-co-operation/nothing-browser.git"
|
|
33
33
|
},
|
|
34
34
|
"bugs": {
|
|
35
|
-
"url": "https://github.com/
|
|
35
|
+
"url": "https://github.com/ernest-tech-house-co-operation/nothing-browser/issues"
|
|
36
36
|
},
|
|
37
37
|
"files": [
|
|
38
38
|
"piggy.ts",
|