brave-real-browser 1.5.106 → 2.0.2

package/README.md

@@ -3,11 +3,11 @@
 
 <br/>
 <p align="center">
-  <a href="https://github.com/zfcsoftware/puppeteer-real-browser">
+  <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">Puppeteer Real Browser</h3>
+  <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.
@@ -22,11 +22,11 @@
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/github/contributors/zfcsoftware/puppeteer-real-browser?color=dark-green" alt="Contributors" />
-  <img src="https://img.shields.io/github/forks/zfcsoftware/puppeteer-real-browser?style=social" alt="Forks" />
-  <img src="https://img.shields.io/github/stars/zfcsoftware/puppeteer-real-browser?style=social" alt="Stargazers" />
-  <img src="https://img.shields.io/github/issues/zfcsoftware/puppeteer-real-browser" alt="Issues" />
-  <img src="https://img.shields.io/github/license/zfcsoftware/puppeteer-real-browser" alt="License" />
+  <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
@@ -38,7 +38,7 @@
 If you are using a Linux operating system, xvfb must be installed for the library to work correctly.
 
 ```bash
-npm i puppeteer-real-browser
+npm i brave-real-browser
 ```
 
 if you are using linux:
@@ -47,44 +47,12 @@ if you are using linux:
 sudo apt-get install xvfb
 ```
 
-### 🚀 Auto-Update Feature
-
-This package **automatically updates all dependencies to their latest versions** whenever you run `npm install`. This ensures you always have the most recent bug fixes and security patches.
-
-**How it works:**
-- ✅ Automatically checks for outdated dependencies on every `npm install`
-- ✅ Updates only the core dependencies (brave-real-launcher, brave-real-puppeteer-core, etc.)
-- ✅ Works in CI/CD environments (GitHub Actions, etc.)
-- ✅ Can be disabled if needed
-
-**To disable auto-update:**
-```bash
-# Temporarily disable for one install
-SKIP_AUTO_UPDATE=true npm install
-
-# Or set environment variable
-export SKIP_AUTO_UPDATE=true
-npm install
-```
-
-**Manual update commands:**
-```bash
-# Check for outdated dependencies
-npm run check-updates
-
-# Update all dependencies manually
-npm run update-deps
-
-# Or use the convenient command
-npm run upgrade-all
-```
-
 ## Include
 
 ### CommonJS
 
 ```js
-const { connect } = require("puppeteer-real-browser");
+const { connect } = require("brave-real-browser");
 
 const start = async () => {
   const { page, browser } = await connect();
@@ -94,7 +62,7 @@ const start = async () => {
 ### Module
 
 ```js
-import { connect } from "puppeteer-real-browser";
+import { connect } from "brave-real-browser";
 
 const { page, browser } = await connect();
 ```
@@ -102,7 +70,7 @@ const { page, browser } = await connect();
 ## Usage
 
 ```js
-const { connect } = require("puppeteer-real-browser");
+const { connect } = require("brave-real-browser");
 
 async function test() {
   const { browser, page } = await connect({
@@ -134,9 +102,9 @@ test();
 **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.
 
 **args:** If there is an additional flag you want to add when starting Chromium, you can send it with this string.
-Supported flags: https://github.com/codeiva4u/Brave-Real-Launcher/blob/main/docs/brave-flags-for-tools.md
+Supported flags: https://github.com/AaronRai123/brave-real-launcher
 
-**customConfig:** https://github.com/codeiva4u/Brave-Real-Launcher The browser is initialized with this library. What you send with this object is added as a direct initialization argument. You should use the initialization values in this repo. You should set the userDataDir option here and if you want to specify a custom brave path, you should set it with the bravePath value.
+**customConfig:** https://github.com/AaronRai123/brave-real-launcher The browser is initialized with this library. What you send with this object is added as a direct initialization argument. You should use the initialization values in this repo. You should set the userDataDir option here and if you want to specify a custom Brave path, you should set it with the bravePath value.
 
 **turnstile:** Cloudflare Turnstile automatically clicks on Captchas if set to true
 
@@ -159,7 +127,7 @@ npm i puppeteer-extra-plugin-click-and-wait
 ```js
 const test = require("node:test");
 const assert = require("node:assert");
-const { connect } = require("puppeteer-real-browser");
+const { connect } = require("brave-real-browser");
 
 test("Puppeteer Extra Plugin", async () => {
   const { page, browser } = await connect({
@@ -186,31 +154,31 @@ You can use the Dockerfile file in the main directory to use this library with d
 To run a test, you can follow these steps
 
 ```bash
-git clone https://github.com/zfcsoftware/puppeteer-real-browser
+git clone https://github.com/codeiva4u/Brave-Real-Browser.git
 ```
 
 ```bash
-cd puppeteer-real-browser
+cd brave-real-browser
 ```
 
 ```bash
-docker build -t puppeteer-real-browser-project .
+docker build -t brave-real-browser-project .
 ```
 
 ```bash
-docker run puppeteer-real-browser-project
+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/zfcsoftware)
+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)
 
 ## Quick Questions and Answers
 
 ### I Cannot Access Functions in Window Object What Should I Do?
 
 This problem is probably caused by the runtime being closed by the rebrowser used.
-https://github.com/zfcsoftware/puppeteer-real-browser/tree/access-window
+https://github.com/codeiva4u/Brave-Real-Browser/tree/access-window
 I created a branch for this. You can access the value you want by adding javascript to the page source with puppeteer-intercept-and-modify-requests as done in success.js. If you know about the Chrome plugin, you can also use it.
 
 ### page.setViewport method is not working, what should I do?
@@ -221,7 +189,7 @@ As with the initialization arguments in the test module, you can set the default
 
 using puppeteer-core patched with rebrowser. Tested with the challenging sites in the test file in headless false mode and passed with flying colors. The only known issue is that the mouse screeenX does not match the mouse position. This has been patched in the library.
 
-The ghost-cursor is included in the library. (https://github.com/zfcsoftware/puppeteer-real-browser/blob/2a5fba37a85c15625fb3c8d1f7cf8dcb109b9492/lib/cjs/module/pageController.js#L54) You can use ghost-cursor with page.realCursor. page.click It is recommended to use page.realClick instead of page.click.
+The ghost-cursor is included in the library. (https://github.com/codeiva4u/Brave-Real-Browser/blob/2a5fba37a85c15625fb3c8d1f7cf8dcb109b9492/lib/cjs/module/pageController.js#L54) You can use ghost-cursor with page.realCursor. page.click It is recommended to use page.realClick instead of page.click.
 
 ### What Makes This Library Special?
 
@@ -237,7 +205,7 @@ Please see the answers in the link above. When there is no Google session, no ma
 
 ## License
 
-Distributed under the MIT License. See [LICENSE](https://github.com/zfcsoftware/puppeteer-real-browser/blob/main/LICENSE.md) for more information.
+Distributed under the MIT License. See [LICENSE](https://github.com/codeiva4u/Brave-Real-Browser/blob/main/LICENSE.md) for more information.
 
 ## Thank You
 

package/lib/cjs/index.js

@@ -1,11 +1,6 @@
 let puppeteer = require("brave-real-puppeteer-core");
 const { pageController } = require("./module/pageController.js");
-let Xvfb
-try {
-  Xvfb = require("xvfb");
-} catch {
-  // ignore
-}
+
 
 async function connect({
   args = [],
@@ -18,29 +13,13 @@ async function connect({
   plugins = [],
   ignoreAllFlags = false,
 } = {}) {
-  const { launch, DEFAULT_FLAGS } = await import("brave-real-launcher");
+  const { launch, BraveLauncher, DEFAULT_FLAGS } = await import("brave-real-launcher");
 
-  let xvfbsession = null;
-  if (headless == "auto") headless = false;
 
-  if (process.platform === "linux" && disableXvfb === false) {
-    try {
-      xvfbsession = new Xvfb({
-        silent: true,
-        xvfb_args: ["-screen", "0", "1920x1080x24", "-ac"],
-      });
-      xvfbsession.startSync();
-    } catch (err) {
-      console.log(
-        "You are running on a Linux platform but do not have xvfb installed. The browser can be captured. Please install it with the following command\n\nsudo apt-get install xvfb\n\n" +
-          err.message
-      );
-    }
-  }
 
-  let chromeFlags;
+  let braveFlags;
   if (ignoreAllFlags === true) {
-    chromeFlags = [
+    braveFlags = [
       ...args,
       ...(headless !== false ? [`--headless=${headless}`] : []),
       ...(proxy && proxy.host && proxy.port
@@ -48,28 +27,20 @@ async function connect({
         : []),
     ];
   } else {
-    // Default flags: https://github.com/codeiva4u/Brave-Real-Launcher/blob/main/src/flags.ts
+    // Use DEFAULT_FLAGS from brave-real-launcher
     const flags = [...DEFAULT_FLAGS];
-    // Add AutomationControlled to "disable-features" flag
-    const indexDisableFeatures = flags.findIndex((flag) => flag.startsWith('--disable-features'));
-    flags[indexDisableFeatures] = `${flags[indexDisableFeatures]},AutomationControlled`;
-    // Remove "disable-component-update" flag
-    const indexComponentUpdateFlag = flags.findIndex((flag) => flag.startsWith('--disable-component-update'));
-    flags.splice(indexComponentUpdateFlag, 1);
-    chromeFlags = [
+    braveFlags = [
       ...flags,
       ...args,
       ...(headless !== false ? [`--headless=${headless}`] : []),
       ...(proxy && proxy.host && proxy.port
         ? [`--proxy-server=${proxy.host}:${proxy.port}`]
         : []),
-      "--no-sandbox",
-      "--disable-dev-shm-usage",
     ];
   }
-  const chrome = await launch({
+  const brave = await launch({
     ignoreDefaultFlags: true,
-    chromeFlags,
+    braveFlags,
     ...customConfig,
   });
 
@@ -84,26 +55,28 @@ async function connect({
   }
 
   const browser = await puppeteer.connect({
-    browserURL: `http://127.0.0.1:${chrome.port}`,
+    browserURL: `http://127.0.0.1:${brave.port}`,
+    defaultViewport: null, // Full window content - no viewport restriction
     ...connectOption,
   });
 
   let [page] = await browser.pages();
 
+  let xvfbsession = null;
   let pageControllerConfig = {
     browser,
     page,
     proxy,
     turnstile,
     xvfbsession,
-    pid: chrome.pid,
+    pid: brave.pid,
     plugins,
   };
 
   page = await pageController({
     ...pageControllerConfig,
     killProcess: true,
-    chrome,
+    brave,
   });
 
   browser.on("targetcreated", async (target) => {

package/lib/cjs/module/pageController.js

@@ -2,175 +2,68 @@ const { createCursor } = require('ghost-cursor');
 const { checkTurnstile } = require('./turnstile.js');
 const kill = require('tree-kill');
 
-// Configuration constants
-const TURNSTILE_CHECK_INTERVAL = 1000; // 1 second
-const TURNSTILE_MAX_ATTEMPTS = 300; // 5 minutes max (300 attempts * 1 second)
-const TURNSTILE_TIMEOUT = 300000; // 5 minutes in milliseconds
-
 function getRandomInt(min, max) {
     min = Math.ceil(min);
     max = Math.floor(max);
     return Math.floor(Math.random() * (max - min + 1)) + min;
 }
 
-async function pageController({ browser, page, proxy, turnstile, xvfbsession, pid, plugins, killProcess = false, chrome }) {
-
-    let solveStatus = turnstile;
-    let turnstileSolverRunning = false;
+async function pageController({ browser, page, proxy, turnstile, xvfbsession, pid, plugins, killProcess = false, brave }) {
 
-    // Safe cleanup function
-    const cleanup = async () => {
-        solveStatus = false;
-        if (killProcess === true) {
-            if (xvfbsession) {
-                try { 
-                    xvfbsession.stopSync();
-                } catch (err) { 
-                    console.error('Error stopping Xvfb session:', err.message);
-                }
-            }
-            if (chrome) {
-                try { 
-                    chrome.kill();
-                } catch (err) { 
-                    console.error('Error killing Chrome process:', err.message);
-                }
-            }
-            if (pid) {
-                try { 
-                    kill(pid, 'SIGKILL', (err) => {
-                        if (err) console.error('Error killing process:', err.message);
-                    });
-                } catch (err) { 
-                    console.error('Error in kill command:', err.message);
-                }
-            }
-        }
-    };
+    let solveStatus = turnstile
 
     page.on('close', () => {
-        solveStatus = false;
+        solveStatus = false
     });
 
+
     browser.on('disconnected', async () => {
-        await cleanup();
+        solveStatus = false
+        if (killProcess === true) {
+            if (xvfbsession) try { xvfbsession.stopSync() } catch (err) { }
+            if (brave) try { brave.kill() } catch (err) { console.log(err); }
+            if (pid) try { kill(pid, 'SIGKILL', () => { }) } catch (err) { }
+        }
     });
 
-    // Enhanced turnstile solver with timeout and max attempts protection
     async function turnstileSolver() {
-        if (turnstileSolverRunning) {
-            console.warn('Turnstile solver already running, skipping duplicate start');
-            return;
-        }
-        
-        turnstileSolverRunning = true;
-        const startTime = Date.now();
-        let attempts = 0;
-
-        try {
-            while (solveStatus && attempts < TURNSTILE_MAX_ATTEMPTS) {
-                // Check timeout
-                if (Date.now() - startTime > TURNSTILE_TIMEOUT) {
-                    console.warn('Turnstile solver timeout reached after', attempts, 'attempts');
-                    break;
-                }
-
-                // Check if page is still valid
-                if (page.isClosed()) {
-                    console.log('Page closed, stopping turnstile solver');
-                    break;
-                }
-
-                attempts++;
-
-                try {
-                    await checkTurnstile({ page });
-                } catch (err) {
-                    // Silent fail for individual checks, log only if debug enabled
-                    if (process.env.DEBUG === 'true') {
-                        console.debug('Turnstile check failed:', err.message);
-                    }
-                }
-
-                // Wait before next check
-                await new Promise(r => setTimeout(r, TURNSTILE_CHECK_INTERVAL));
-            }
-
-            if (attempts >= TURNSTILE_MAX_ATTEMPTS) {
-                console.warn('Turnstile solver stopped: max attempts reached');
-            }
-        } catch (err) {
-            console.error('Error in turnstile solver:', err.message);
-        } finally {
-            turnstileSolverRunning = false;
+        while (solveStatus) {
+            await checkTurnstile({ page }).catch(() => { });
+            await new Promise(r => setTimeout(r, 1000));
         }
+        return
     }
 
-    // Start turnstile solver only if enabled
-    if (turnstile) {
-        turnstileSolver().catch(err => {
-            console.error('Failed to start turnstile solver:', err.message);
-        });
-    }
+    turnstileSolver()
 
-    // Proxy authentication with error handling
-    if (proxy && proxy.username && proxy.password) {
-        try {
-            await page.authenticate({ 
-                username: proxy.username, 
-                password: proxy.password 
-            });
-        } catch (err) {
-            console.error('Proxy authentication failed:', err.message);
-            throw new Error(`Failed to authenticate proxy: ${err.message}`);
-        }
-    }
+    if (proxy.username && proxy.password) await page.authenticate({ username: proxy.username, password: proxy.password });
 
-    // Plugin initialization with error handling
-    if (plugins && plugins.length > 0) {
+    if (plugins.length > 0) {
         for (const plugin of plugins) {
-            try {
-                if (plugin && typeof plugin.onPageCreated === 'function') {
-                    await plugin.onPageCreated(page);
-                }
-            } catch (err) {
-                console.error('Plugin initialization failed:', err.message);
-                // Continue with other plugins even if one fails
-            }
+            plugin.onPageCreated(page)
         }
     }
 
-    // Mouse event handling with error handling
-    try {
-        await page.evaluateOnNewDocument(() => {
-            Object.defineProperty(MouseEvent.prototype, 'screenX', {
-                get: function () {
-                    return this.clientX + window.screenX;
-                }
-            });
-
-            Object.defineProperty(MouseEvent.prototype, 'screenY', {
-                get: function () {
-                    return this.clientY + window.screenY;
-                }
-            });
+    await page.evaluateOnNewDocument(() => {
+        Object.defineProperty(MouseEvent.prototype, 'screenX', {
+            get: function () {
+                return this.clientX + window.screenX;
+            }
         });
-    } catch (err) {
-        console.error('Failed to setup mouse event handlers:', err.message);
-        // Non-critical, continue anyway
-    }
 
-    // Cursor setup with error handling
-    try {
-        const cursor = createCursor(page);
-        page.realCursor = cursor;
-        page.realClick = cursor.click;
-    } catch (err) {
-        console.error('Failed to create ghost cursor:', err.message);
-        // Non-critical, continue anyway
-    }
+        Object.defineProperty(MouseEvent.prototype, 'screenY', {
+            get: function () {
+                return this.clientY + window.screenY;
+            }
+        });
+
+    });
+
+    const cursor = createCursor(page);
+    page.realCursor = cursor
+    page.realClick = cursor.click
 
-    return page;
+    return page
 }
 
 module.exports = { pageController }

package/lib/esm/index.mjs

@@ -1,4 +1,4 @@
-import { launch, DEFAULT_FLAGS } from "brave-real-launcher";
+import { launch, BraveLauncher, DEFAULT_FLAGS } from "brave-real-launcher";
 import puppeteer from "brave-real-puppeteer-core";
 import { pageController } from "./module/pageController.mjs";
 
@@ -14,28 +14,11 @@ export async function connect({
   plugins = [],
   ignoreAllFlags = false,
 } = {}) {
-  let xvfbsession = null;
-  if (headless == "auto") headless = false;
 
-  if (process.platform === "linux" && disableXvfb === false) {
-    try {
-      const { default: Xvfb } = await import("xvfb");
-      xvfbsession = new Xvfb({
-        silent: true,
-        xvfb_args: ["-screen", "0", "1920x1080x24", "-ac"],
-      });
-      xvfbsession.startSync();
-    } catch (err) {
-      console.log(
-        "You are running on a Linux platform but do not have xvfb installed. The browser can be captured. Please install it with the following command\n\nsudo apt-get install xvfb\n\n" +
-          err.message
-      );
-    }
-  }
 
-  let chromeFlags;
+  let braveFlags;
   if (ignoreAllFlags === true) {
-    chromeFlags = [
+    braveFlags = [
       ...args,
       ...(headless !== false ? [`--headless=${headless}`] : []),
       ...(proxy && proxy.host && proxy.port
@@ -43,28 +26,20 @@ export async function connect({
         : []),
     ];
   } else {
-    // Default flags: https://github.com/codeiva4u/Brave-Real-Launcher/blob/main/src/flags.ts
+    // Use DEFAULT_FLAGS from brave-real-launcher
     const flags = [...DEFAULT_FLAGS];
-    // Add AutomationControlled to "disable-features" flag
-    const indexDisableFeatures = flags.findIndex((flag) => flag.startsWith('--disable-features'));
-    flags[indexDisableFeatures] = `${flags[indexDisableFeatures]},AutomationControlled`;
-    // Remove "disable-component-update" flag
-    const indexComponentUpdateFlag = flags.findIndex((flag) => flag.startsWith('--disable-component-update'));
-    flags.splice(indexComponentUpdateFlag, 1);
-    chromeFlags = [
+    braveFlags = [
       ...flags,
       ...args,
       ...(headless !== false ? [`--headless=${headless}`] : []),
       ...(proxy && proxy.host && proxy.port
         ? [`--proxy-server=${proxy.host}:${proxy.port}`]
         : []),
-      "--no-sandbox",
-      "--disable-dev-shm-usage",
     ];
   }
-  const chrome = await launch({
+  const brave = await launch({
     ignoreDefaultFlags: true,
-    chromeFlags,
+    braveFlags,
     ...customConfig,
   });
   let pextra = null;
@@ -79,25 +54,27 @@ export async function connect({
   }
 
   const browser = await (pextra ? pextra : puppeteer).connect({
-    browserURL: `http://127.0.0.1:${chrome.port}`,
+    browserURL: `http://127.0.0.1:${brave.port}`,
+    defaultViewport: null, // Full window content - no viewport restriction
     ...connectOption,
   });
 
   let [page] = await browser.pages();
 
+  let xvfbsession = null;
   let pageControllerConfig = {
     browser,
     page,
     proxy,
     turnstile,
     xvfbsession,
-    pid: chrome.pid,
+    pid: brave.pid,
     plugins,
   };
 
   page = await pageController({
     ...pageControllerConfig,
-    chrome,
+    brave,
     killProcess: true,
   });