brave-real-browser 2.0.1 → 2.0.3

package/README.md

@@ -1,37 +1,3 @@
-> [!WARNING]
-> This repo will no longer receive updates. Thank you to everyone who supported it.
-
-<br/>
-<p align="center">
-  <a href="https://github.com/codeiva4u/Brave-Real-Browser">
-    <img src="https://github.com/zfcsoftware/puppeteer-real-browser/assets/123484092/cc8b5fb9-504a-4fd3-97f6-a51990bb4303" alt="Logo" width="80" height="80">
-  </a>
-
-  <h3 align="center">Brave Real Browser</h3>
-
-  <p align="center">
-    This package prevents Puppeteer from being detected as a bot in services like Cloudflare and allows you to pass captchas without any problems. It behaves like a real browser.
-    <br/>
-    <br/>
-    If you are only interested in Cloudflare WAF, please check this repo:<br/> https://github.com/zfcsoftware/cf-clearance-scraper
-  </p>
-</p>
-
-<p align="center">
-<video src='https://github.com/user-attachments/assets/5dddca09-6941-42e9-9427-5c666632483f'/>
-</p>
-
-<p align="center">
-  <img src="https://img.shields.io/github/contributors/codeiva4u/Brave-Real-Browser?color=dark-green" alt="Contributors" />
-  <img src="https://img.shields.io/github/forks/codeiva4u/Brave-Real-Browser?style=social" alt="Forks" />
-  <img src="https://img.shields.io/github/stars/codeiva4u/Brave-Real-Browser?style=social" alt="Stargazers" />
-  <img src="https://img.shields.io/github/issues/codeiva4u/Brave-Real-Browser" alt="Issues" />
-  <img src="https://img.shields.io/github/license/codeiva4u/Brave-Real-Browser" alt="License" />
-</p>
-
-## Sponsor
-
-[![ScrapeDo](data/sdo.gif)](https://scrape.do/?utm_source=github&utm_medium=repo_prb)
 
 ## Installation
 
@@ -47,56 +13,33 @@ if you are using linux:
 sudo apt-get install xvfb
 ```
 
-## Include
+## Docker
 
-### CommonJS
+You can use the Dockerfile file in the main directory to use this library with docker. It has been tested with docker on Ubuntu server operating systems.
 
-```js
-const { connect } = require("brave-real-browser");
+To run a test, you can follow these steps
 
-const start = async () => {
-  const { page, browser } = await connect();
-};
+```bash
+git clone https://github.com/codeiva4u/Brave-Real-Browser.git
 ```
 
-### Module
-
-```js
-import { connect } from "brave-real-browser";
-
-const { page, browser } = await connect();
+```bash
+cd brave-real-browser
+```
+```bash
+npm run cjs_test
 ```
 
-## Usage
-
-```js
-const { connect } = require("brave-real-browser");
-
-async function test() {
-  const { browser, page } = await connect({
-    headless: false,
-
-    args: [],
-
-    customConfig: {},
-
-    turnstile: true,
-
-    connectOption: {},
+```bash
+npm run esm_test
+```
 
-    disableXvfb: false,
-    ignoreAllFlags: false,
-    // proxy:{
-    //     host:'<proxy-host>',
-    //     port:'<proxy-port>',
-    //     username:'<proxy-username>',
-    //     password:'<proxy-password>'
-    // }
-  });
-  await page.goto("<url>");
-}
+```bash
+docker build -t brave-real-browser-project .
+```
 
-test();
+```bash
+docker run brave-real-browser-project
 ```
 
 **headless**: The default value is false. Values such as “new”, true, “shell” can also be sent, but it works most stable when false is used.
@@ -124,51 +67,6 @@ The following is an example of installing a plugin. You can install other plugin
 npm i puppeteer-extra-plugin-click-and-wait
 ```
 
-```js
-const test = require("node:test");
-const assert = require("node:assert");
-const { connect } = require("brave-real-browser");
-
-test("Puppeteer Extra Plugin", async () => {
-  const { page, browser } = await connect({
-    args: ["--start-maximized"],
-    turnstile: true,
-    headless: false,
-    // disableXvfb: true,
-    customConfig: {},
-    connectOption: {
-      defaultViewport: null,
-    },
-    plugins: [require("puppeteer-extra-plugin-click-and-wait")()],
-  });
-  await page.goto("https://google.com", { waitUntil: "domcontentloaded" });
-  await page.clickAndWaitForNavigation("body");
-  await browser.close();
-});
-```
-
-## Docker
-
-You can use the Dockerfile file in the main directory to use this library with docker. It has been tested with docker on Ubuntu server operating systems.
-
-To run a test, you can follow these steps
-
-```bash
-git clone https://github.com/codeiva4u/Brave-Real-Browser.git
-```
-
-```bash
-cd brave-real-browser
-```
-
-```bash
-docker build -t brave-real-browser-project .
-```
-
-```bash
-docker run brave-real-browser-project
-```
-
 ## Support Us
 
 This library is completely open source and is constantly being updated. Please star this repo to support this project. Starring and supporting the project will ensure that it receives updates. If you want to support it further, you can consider sponsoring me (https://github.com/sponsors/codeiva4u)

package/lib/cjs/index.js

@@ -56,6 +56,7 @@ async function connect({
 
   const browser = await puppeteer.connect({
     browserURL: `http://127.0.0.1:${brave.port}`,
+    defaultViewport: null, // Full window content - no viewport restriction
     ...connectOption,
   });
 

package/lib/esm/index.mjs

@@ -55,6 +55,7 @@ export async function connect({
 
   const browser = await (pextra ? pextra : puppeteer).connect({
     browserURL: `http://127.0.0.1:${brave.port}`,
+    defaultViewport: null, // Full window content - no viewport restriction
     ...connectOption,
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-browser",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "This package is designed to bypass puppeteer's bot-detecting captchas such as Cloudflare. It acts like a real browser and can be managed with puppeteer.",
   "main": "lib/cjs/index.js",
   "module": "lib/esm/index.mjs",
@@ -36,8 +36,8 @@
   "author": "codeiva4u",
   "license": "ISC",
   "dependencies": {
-    "brave-real-launcher": "^1.2.40",
-    "brave-real-puppeteer-core": "^24.34.0-patch.5",
+    "brave-real-launcher": "^1.2.43",
+    "brave-real-puppeteer-core": "^24.34.0-patch.9",
     "ghost-cursor": "^1.4.1",
     "puppeteer-extra": "^3.3.6",
     "tree-kill": "^1.2.2",

package/test/cjs/test.js

@@ -2,53 +2,50 @@ const test = require('node:test');
 const assert = require('node:assert');
 const { connect } = require('../../lib/cjs/index.js');
 
-
 const realBrowserOption = {
-    args: ["--start-minimized"],
     turnstile: true,
     headless: false,
-    // disableXvfb: true,
     customConfig: {},
-    connectOption: {
-        defaultViewport: null
-    },
     plugins: []
 }
 
-// test('Puppeteer Extra Plugin', async () => {
-//     /*
-//     Run with:
-//     npm i puppeteer-extra-plugin-click-and-wait
-//     */
-//     realBrowserOption.plugins = [
-//         require('puppeteer-extra-plugin-click-and-wait')()
-//     ]
-//     const { page, browser } = await connect(realBrowserOption)
-//     await page.goto("https://google.com", { waitUntil: "domcontentloaded" })
-//     await page.clickAndWaitForNavigation('body')
-//     await browser.close()
-// })
+// Shared browser instance for all tests
+let browser = null;
+let page = null;
+
+// Setup - Run once before all tests
+test.before(async () => {
+    console.log('🚀 Starting browser for all tests...');
+    const result = await connect(realBrowserOption);
+    browser = result.browser;
+    page = result.page;
+    console.log('✅ Browser started successfully');
+});
+
+// Teardown - Run once after all tests
+test.after(async () => {
+    console.log('🏁 Closing browser after all tests...');
+    if (browser) {
+        await browser.close();
+        console.log('✅ Browser closed successfully');
+    }
+});
 
 test('DrissionPage Detector', async () => {
-    const { page, browser } = await connect(realBrowserOption)
     await page.goto("https://web.archive.org/web/20240913054632/https://drissionpage.pages.dev/");
     await page.realClick("#detector")
     let result = await page.evaluate(() => { return document.querySelector('#isBot span').textContent.includes("not") ? true : false })
-    await browser.close()
     assert.strictEqual(result, true, "DrissionPage Detector test failed!")
 })
 
 test('Brotector, a webdriver detector', async () => {
-    const { page, browser } = await connect(realBrowserOption)
     await page.goto("https://kaliiiiiiiiii.github.io/brotector/");
     await new Promise(r => setTimeout(r, 3000));
     let result = await page.evaluate(() => { return document.querySelector('#table-keys').getAttribute('bgcolor') })
-    await browser.close()
     assert.strictEqual(result === "darkgreen", true, "Brotector, a webdriver detector test failed!")
 })
 
 test('Cloudflare WAF', async () => {
-    const { page, browser } = await connect(realBrowserOption)
     await page.goto("https://nopecha.com/demo/cloudflare");
     let verify = null
     let startDate = Date.now()
@@ -60,13 +57,11 @@ test('Cloudflare WAF', async () => {
         }).catch(() => null)
         await new Promise(r => setTimeout(r, 2000));
     }
-    await browser.close()
     assert.strictEqual(verify === true, true, "Cloudflare WAF test failed! (Site may be blocking automated access)")
 })
 
 
 test('Cloudflare Turnstile', async () => {
-    const { page, browser } = await connect(realBrowserOption)
     await page.goto("https://2captcha.com/demo/cloudflare-turnstile");
     await page.waitForSelector('.cf-turnstile')
     let token = null
@@ -82,14 +77,11 @@ test('Cloudflare Turnstile', async () => {
         })
         await new Promise(r => setTimeout(r, 1000));
     }
-    await browser.close()
-    // if (token !== null) console.log('Cloudflare Turnstile Token: ' + token);
     assert.strictEqual(token !== null, true, "Cloudflare turnstile test failed!")
 })
 
 
 test('Fingerprint JS Bot Detector', async () => {
-    const { page, browser } = await connect(realBrowserOption)
     await page.goto("https://fingerprint.com/products/bot-detection/");
     await new Promise(r => setTimeout(r, 8000));
     const detect = await page.evaluate(() => {
@@ -111,30 +103,24 @@ test('Fingerprint JS Bot Detector', async () => {
         }
         return false;
     })
-    await browser.close()
     assert.strictEqual(detect, true, "Fingerprint JS Bot Detector test failed!")
 })
 
 
 // If you fail this test, your ip address probably has a high spam score. Please use a mobile or clean ip address.
 test('Datadome Bot Detector', async (t) => {
-    const { page, browser } = await connect(realBrowserOption)
     await page.goto("https://antoinevastel.com/bots/datadome");
     const check = await page.waitForSelector('nav #navbarCollapse').catch(() => null)
-    await browser.close()
     assert.strictEqual(check ? true : false, true, "Datadome Bot Detector test failed! [This may also be because your ip address has a high spam score. Please try with a clean ip address.]")
 })
 
 // If this test fails, please first check if you can access https://antcpt.com/score_detector/
 test('Recaptcha V3 Score (hard)', async () => {
-    const { page, browser } = await connect(realBrowserOption)
     await page.goto("https://antcpt.com/score_detector/");
     await page.realClick("button")
     await new Promise(r => setTimeout(r, 5000));
     const score = await page.evaluate(() => {
         return document.querySelector('big').textContent.replace(/[^0-9.]/g, '')
     })
-    await browser.close()
-    // if (Number(score) >= 0.7) console.log('Recaptcha V3 Score: ' + score);
     assert.strictEqual(Number(score) >= 0.7, true, "(please first check if you can access https://antcpt.com/score_detector/.) Recaptcha V3 Score (hard) should be >=0.7. Score Result: " + score)
 })

package/test/esm/test.js

@@ -3,54 +3,49 @@ import assert from 'node:assert';
 import { connect } from '../../lib/esm/index.mjs';
 
 const realBrowserOption = {
-    args: ["--start-minimized"],
     turnstile: true,
     headless: false,
-    // disableXvfb: true,
-    // ignoreAllFlags:true,
     customConfig: {},
-    connectOption: {
-        defaultViewport: null
-    },
     plugins: []
 }
 
+// Shared browser instance for all tests
+let browser = null;
+let page = null;
 
-// test('Puppeteer Extra Plugin', async () => {
-//     /*
-//     Run with:
-//     npm i puppeteer-extra-plugin-click-and-wait
-//     */
-//     const clickAndWait = await (await import('puppeteer-extra-plugin-click-and-wait')).default
-//     realBrowserOption.plugins = [
-//         clickAndWait()
-//     ]
-//     const { page, browser } = await connect(realBrowserOption)
-//     await page.goto("https://google.com", { waitUntil: "domcontentloaded" })
-//     await page.clickAndWaitForNavigation('body')
-//     await browser.close()
-// })
+// Setup - Run once before all tests
+test.before(async () => {
+    console.log('🚀 Starting browser for all tests...');
+    const result = await connect(realBrowserOption);
+    browser = result.browser;
+    page = result.page;
+    console.log('✅ Browser started successfully');
+});
+
+// Teardown - Run once after all tests
+test.after(async () => {
+    console.log('🏁 Closing browser after all tests...');
+    if (browser) {
+        await browser.close();
+        console.log('✅ Browser closed successfully');
+    }
+});
 
 test('DrissionPage Detector', async () => {
-    const { page, browser } = await connect(realBrowserOption)
     await page.goto("https://web.archive.org/web/20240913054632/https://drissionpage.pages.dev/");
     await page.realClick("#detector")
     let result = await page.evaluate(() => { return document.querySelector('#isBot span').textContent.includes("not") ? true : false })
-    await browser.close()
     assert.strictEqual(result, true, "DrissionPage Detector test failed!")
 })
 
 test('Brotector, a webdriver detector', async () => {
-    const { page, browser } = await connect(realBrowserOption)
     await page.goto("https://kaliiiiiiiiii.github.io/brotector/");
     await new Promise(r => setTimeout(r, 3000));
     let result = await page.evaluate(() => { return document.querySelector('#table-keys').getAttribute('bgcolor') })
-    await browser.close()
     assert.strictEqual(result === "darkgreen", true, "Brotector, a webdriver detector test failed!")
 })
 
 test('Cloudflare WAF', async () => {
-    const { page, browser } = await connect(realBrowserOption)
     await page.goto("https://nopecha.com/demo/cloudflare");
     let verify = null
     let startDate = Date.now()
@@ -62,13 +57,11 @@ test('Cloudflare WAF', async () => {
         }).catch(() => null)
         await new Promise(r => setTimeout(r, 2000));
     }
-    await browser.close()
     assert.strictEqual(verify === true, true, "Cloudflare WAF test failed! (Site may be blocking automated access)")
 })
 
 
 test('Cloudflare Turnstile', async () => {
-    const { page, browser } = await connect(realBrowserOption)
     await page.goto("https://2captcha.com/demo/cloudflare-turnstile");
     await page.waitForSelector('.cf-turnstile')
     let token = null
@@ -84,15 +77,12 @@ test('Cloudflare Turnstile', async () => {
         })
         await new Promise(r => setTimeout(r, 1000));
     }
-    await browser.close()
-    // if (token !== null) console.log('Cloudflare Turnstile Token: ' + token);
     assert.strictEqual(token !== null, true, "Cloudflare turnstile test failed!")
 })
 
 
 
 test('Fingerprint JS Bot Detector', async () => {
-    const { page, browser } = await connect(realBrowserOption)
     await page.goto("https://fingerprint.com/products/bot-detection/");
     await new Promise(r => setTimeout(r, 8000));
     const detect = await page.evaluate(() => {
@@ -114,30 +104,24 @@ test('Fingerprint JS Bot Detector', async () => {
         }
         return false;
     })
-    await browser.close()
     assert.strictEqual(detect, true, "Fingerprint JS Bot Detector test failed!")
 })
 
 
 // If you fail this test, your ip address probably has a high spam score. Please use a mobile or clean ip address.
 test('Datadome Bot Detector', async (t) => {
-    const { page, browser } = await connect(realBrowserOption)
     await page.goto("https://antoinevastel.com/bots/datadome");
     const check = await page.waitForSelector('nav #navbarCollapse').catch(() => null)
-    await browser.close()
     assert.strictEqual(check ? true : false, true, "Datadome Bot Detector test failed! [This may also be because your ip address has a high spam score. Please try with a clean ip address.]")
 })
 
 // If this test fails, please first check if you can access https://antcpt.com/score_detector/
 test('Recaptcha V3 Score (hard)', async () => {
-    const { page, browser } = await connect(realBrowserOption)
     await page.goto("https://antcpt.com/score_detector/");
     await page.realClick("button")
     await new Promise(r => setTimeout(r, 5000));
     const score = await page.evaluate(() => {
         return document.querySelector('big').textContent.replace(/[^0-9.]/g, '')
     })
-    await browser.close()
-    // if (Number(score) >= 0.7) console.log('Recaptcha V3 Score: ' + score);
     assert.strictEqual(Number(score) >= 0.7, true, "(please first check if you can access https://antcpt.com/score_detector/.) Recaptcha V3 Score (hard) should be >=0.7. Score Result: " + score)
 })