gologin 3.0.1 → 3.0.3

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 Combined changelog for GoLogin node.js SDK
 
+## [3.0.3] 2026-08-03
+
+### Fixes
+
+* Fixed Chrome extensions download race when the same extension IDs are listed in both `chromeExtensions` and `userChromeExtensions`
+* Made extension archive deletion ignore missing files (`ENOENT`) during parallel extract cleanup
+
+### Features
+
+* Added profile start step timings via `debug` (`DEBUG=gologin`)
+
+## [3.0.2] 2026-07-29
+
+### Features
+
+* Added `customChromeFrame` option to control writing `browser.custom_chrome_frame: false` into profile Preferences
+
 ## [3.0.1] 2026-07-28
 
 ### Fixes

package/examples/puppeter/cloud-browser.js

@@ -2,8 +2,8 @@
 // It will handle the browser start and close management - you just need to control the browser with puppeteer
 import puppeteer from 'puppeteer-core';
 
-const token = process.env.GL_API_TOKEN || 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqd3RpZCI6IjZhNjM4NDk5YWFlYTkyY2Q4YzE3NjcwNyIsInR5cGUiOiJ1c2VyIiwic3ViIjoiNjkyNjI0YTMzMTQ1YzRjMGU5MDBmNmNkIn0.vA0bWpR47ozYcNFl4DMLxqjg1veYS2gNAYpVJKMtYQ4';
-const profileId = '6a294f7a398a99123f1d2a4a';
+const token = process.env.GL_API_TOKEN || 'your dev token here';
+const profileId = 'profile ID';
 
 const CLOUD_BROWSER_URL = `https://cloudbrowser.gologin.com/connect?token=${token}&profile=${profileId}`;
 const STOP_PROFILE_URL = `https://api.gologin.com/browser/${profileId}/web`;
@@ -31,7 +31,9 @@ async function main() {
   const page = await browser.newPage();
 
   await page.goto('https://iphey.com/', { waitUntil: 'networkidle2' });
-  await page.screenshot({ path: 'screenshot.png' });
+  const status = await page.$eval('.trustworthy:not(.hide)',
+    (elt) => elt?.innerText?.trim(),
+  );
 
   return status;
 }

package/index.d.ts

@@ -20,6 +20,7 @@ export type GoLoginOptions = {
   proxyCheckAttempts?: number;
   autoUpdateBrowser?: boolean;
   checkBrowserUpdate?: boolean;
+  customChromeFrame?: boolean;
 };
 
 export type GoLoginStartResult = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gologin",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "description": "A high-level API to control Orbita browser over GoLogin API",
   "types": "./index.d.ts",
   "main": "./src/index.js",

package/src/extensions/extensions-extractor.js

@@ -29,11 +29,13 @@ export const deleteExtensionArchive = (dest) => {
     throw new Error('Missing parameter');
   }
 
-  return access(dest)
-    .then(
-      () => unlink(dest),
-      () => Promise.resolve(),
-    );
+  return unlink(dest).catch((error) => {
+    if (error?.code === 'ENOENT') {
+      return;
+    }
+
+    throw error;
+  });
 };
 
 const withRetry = optionsOrUndefined => {

package/src/extensions/extensions-manager.js

@@ -107,11 +107,13 @@ export class ExtensionsManager extends UserExtensionsManager {
 
       return originalId;
     });
+    const queuedOriginalIds = new Set();
 
     return profileExtensions.reduce((res, val) => {
       const [originalId] = val.split('@');
-      const extensionExists = existedOriginalIds.includes(originalId);
+      const extensionExists = existedOriginalIds.includes(originalId) || queuedOriginalIds.has(originalId);
       if (!extensionExists) {
+        queuedOriginalIds.add(originalId);
         res.push(val);
       }
 

package/src/gologin.js

@@ -40,6 +40,15 @@ const PROXY_NONE = 'none';
 const debug = debugDefault('gologin');
 const delay = (time) => new Promise((resolve) => setTimeout(resolve, time));
 
+const withTiming = async ({ name, promise }) => {
+  const start = Date.now();
+  try {
+    return await promise;
+  } finally {
+    debug(`[timing] ${name}: ${Date.now() - start}ms`);
+  }
+};
+
 export class GoLogin {
   constructor(options = {}) {
     this.browserLang = 'en-US';
@@ -78,6 +87,7 @@ export class GoLogin {
     this.newProxyOrbitaMajorVersion = 135;
     this.proxyCheckTimeout = options.proxyCheckTimeout || 13 * 1000;
     this.proxyCheckAttempts = options.proxyCheckAttempts || 3;
+    this.customChromeFrame = options.customChromeFrame;
 
     if (options.tmpdir) {
       this.tmpdir = options.tmpdir;
@@ -462,13 +472,17 @@ export class GoLogin {
   }
 
   async createStartup(local = false) {
+    const startupStart = Date.now();
     const profilePath = join(this.tmpdir, `gologin_profile_${this.profile_id}`);
     const startupDepsPromise = preloadStartupDeps();
 
     const [profile] = await Promise.all([
-      this.getProfile(),
-      startupDepsPromise.then(() => removePath(profilePath)
-        .then(() => debug('-', profilePath, 'dropped'))),
+      withTiming({ name: 'getProfile', promise: this.getProfile() }),
+      withTiming({
+        name: 'preloadDepsAndClearProfile',
+        promise: startupDepsPromise.then(() => removePath(profilePath)
+          .then(() => debug('-', profilePath, 'dropped'))),
+      }),
     ]);
 
     if (!profile) {
@@ -524,37 +538,54 @@ export class GoLogin {
     this.proxy = proxy;
 
     await Promise.all([
-      this.resolveProfileBrowserVersion(profile),
-      this.initProfileStorage({ profile, local }),
-      this.getTimeZone(proxy).catch((e) => {
-        console.error('Proxy Error. Check it and try again.');
-        throw new Error(`Proxy Error. ${e.message}`);
+      withTiming({ name: 'resolveProfileBrowserVersion', promise: this.resolveProfileBrowserVersion(profile) }),
+      withTiming({ name: 'initProfileStorage', promise: this.initProfileStorage({ profile, local }) }),
+      withTiming({
+        name: 'getTimeZone',
+        promise: this.getTimeZone(proxy).catch((e) => {
+          console.error('Proxy Error. Check it and try again.');
+          throw new Error(`Proxy Error. ${e.message}`);
+        }),
       }),
-      this.initCookiesFile(profile),
+      withTiming({ name: 'initCookiesFile', promise: this.initCookiesFile(profile) }),
     ]);
 
-    await _promises.rm(join(profilePath, 'Default', 'Sync Data'), { recursive: true }).catch(() => null);
-    const pref_file_name = join(profilePath, 'Default', 'Preferences');
-    debug('reading', pref_file_name);
-
-    const prefFileExists = await access(pref_file_name).then(() => true).catch(() => false);
-    if (!prefFileExists) {
-      debug('Preferences file not exists waiting', pref_file_name, '. Using empty profile');
-      await mkdir(join(profilePath, 'Default'), { recursive: true });
-      await writeFile(pref_file_name, '{}');
-    }
+    await withTiming({
+      name: 'preparePreferencesFile',
+      promise: (async () => {
+        await _promises.rm(join(profilePath, 'Default', 'Sync Data'), { recursive: true }).catch(() => null);
+        const pref_file_name = join(profilePath, 'Default', 'Preferences');
+        debug('reading', pref_file_name);
+
+        const prefFileExists = await access(pref_file_name).then(() => true).catch(() => false);
+        if (!prefFileExists) {
+          debug('Preferences file not exists waiting', pref_file_name, '. Using empty profile');
+          await mkdir(join(profilePath, 'Default'), { recursive: true });
+          await writeFile(pref_file_name, '{}');
+        }
+      })(),
+    });
 
-    const preferences_raw = await readFile(pref_file_name);
+    const preferences_raw = await withTiming({
+      name: 'readPreferences',
+      promise: readFile(join(profilePath, 'Default', 'Preferences')),
+    });
     const preferences = JSON.parse(preferences_raw.toString());
     const chromeExtensions = get(profile, 'chromeExtensions') || [];
     const userChromeExtensions = get(profile, 'userChromeExtensions') || [];
-    const allExtensions = [...chromeExtensions, ...userChromeExtensions];
+    const allExtensions = [...new Set([...chromeExtensions, ...userChromeExtensions])];
 
     const [, orbitaParamsToken] = await Promise.all([
-      this.setupProfileExtensions({
-        preferences, allExtensions, userChromeExtensions, profilePath,
+      withTiming({
+        name: 'setupProfileExtensions',
+        promise: this.setupProfileExtensions({
+          preferences,
+          allExtensions,
+          userChromeExtensions: [...new Set(userChromeExtensions)],
+          profilePath,
+        }),
       }),
-      this.fetchOrbitaParamsToken(profile),
+      withTiming({ name: 'fetchOrbitaParamsToken', promise: this.fetchOrbitaParamsToken(profile) }),
     ]);
 
     if (this.fontsMasking) {
@@ -581,6 +612,13 @@ export class GoLogin {
 
     this.browserLang = isMAC ? 'en-US' : checkAutoLangResult;
     const prefsToWrite = Object.assign(preferences, { gologin });
+    if (this.customChromeFrame === false) {
+      prefsToWrite.browser = {
+        ...(prefsToWrite.browser || {}),
+        custom_chrome_frame: false,
+      };
+    }
+
     if (this.browserMajorVersion >= this.newProxyOrbitaMajorVersion && this.proxy?.mode !== 'none') {
       prefsToWrite.proxy = {
         mode: 'fixed_servers',
@@ -598,14 +636,21 @@ export class GoLogin {
       },
     };
 
-    await writeFile(join(profilePath, 'orbita.config'), JSON.stringify(orbitaConfig, null, '\t'), { encoding: 'utf-8' }).catch(console.log);
-    await writeFile(join(profilePath, 'Default', 'Preferences'), JSON.stringify(prefsToWrite));
+    await withTiming({
+      name: 'writeProfileFiles',
+      promise: (async () => {
+        await writeFile(join(profilePath, 'orbita.config'), JSON.stringify(orbitaConfig, null, '\t'), { encoding: 'utf-8' }).catch(console.log);
+        await writeFile(join(profilePath, 'Default', 'Preferences'), JSON.stringify(prefsToWrite));
+
+        const bookmarksParsedData = await getCurrentProfileBookmarks(this.bookmarksFilePath);
+        const bookmarksFromDb = profile.bookmarks?.bookmark_bar;
+        bookmarksParsedData.roots = bookmarksFromDb ? profile.bookmarks : bookmarksParsedData.roots;
+        await writeFile(this.bookmarksFilePath, JSON.stringify(bookmarksParsedData));
+      })(),
+    });
 
-    const bookmarksParsedData = await getCurrentProfileBookmarks(this.bookmarksFilePath);
-    const bookmarksFromDb = profile.bookmarks?.bookmark_bar;
-    bookmarksParsedData.roots = bookmarksFromDb ? profile.bookmarks : bookmarksParsedData.roots;
-    await writeFile(this.bookmarksFilePath, JSON.stringify(bookmarksParsedData));
     debug('Profile ready. Path: ', profilePath, 'PROXY', JSON.stringify(get(preferences, 'gologin.proxy')));
+    debug(`[timing] createStartup total: ${Date.now() - startupStart}ms`);
 
     return profilePath;
   }
@@ -715,8 +760,9 @@ export class GoLogin {
 
       const profileExtensionPathRes = extensionsResult.find(el => 'profileExtensionsCheckRes' in el) || {};
       const profileUserExtensionPathRes = extensionsResult.find(el => 'profileUserExtensionsCheckRes' in el);
-      profileExtensionsCheckRes =
-        (profileExtensionPathRes?.profileExtensionsCheckRes || []).concat(profileUserExtensionPathRes?.profileUserExtensionsCheckRes || []);
+      profileExtensionsCheckRes = [...new Set(
+        (profileExtensionPathRes?.profileExtensionsCheckRes || []).concat(profileUserExtensionPathRes?.profileUserExtensionsCheckRes || []),
+      )];
     }
 
     let extSettings;
@@ -970,9 +1016,13 @@ export class GoLogin {
   }
 
   async spawnBrowser() {
+    const spawnStart = Date.now();
     let { remote_debugging_port, customArgs } = this;
     if (!remote_debugging_port) {
-      remote_debugging_port = await this.getRandomPort();
+      remote_debugging_port = await withTiming({
+        name: 'getRandomPort',
+        promise: this.getRandomPort(),
+      });
     }
 
     const profile_path = this.profilePath();
@@ -988,7 +1038,10 @@ export class GoLogin {
 
     let ORBITA_BROWSER = this.executablePath;
     if (!ORBITA_BROWSER) {
-      const browserChecker = await this.getBrowserChecker();
+      const browserChecker = await withTiming({
+        name: 'getBrowserChecker',
+        promise: this.getBrowserChecker(),
+      });
       ORBITA_BROWSER = browserChecker.getOrbitaPath;
     }
 
@@ -999,9 +1052,12 @@ export class GoLogin {
       env[key] = process.env[key];
     });
 
-    const tz = await this.getTimeZone(this.proxy).catch((e) => {
-      console.error('Proxy Error. Check it and try again.');
-      throw e;
+    const tz = await withTiming({
+      name: 'getTimeZone',
+      promise: this.getTimeZone(this.proxy).catch((e) => {
+        console.error('Proxy Error. Check it and try again.');
+        throw e;
+      }),
     });
 
     env.TZ = tz;
@@ -1082,17 +1138,23 @@ export class GoLogin {
 
     if (this.waitWebsocket) {
       debug('GETTING WS URL FROM BROWSER');
-      const data = await makeRequest(
-        `http://127.0.0.1:${remote_debugging_port}/json/version`,
-        { json: true, maxAttempts: 60, retryDelay: 100, method: 'GET' },
-      );
+      const data = await withTiming({
+        name: 'waitWebsocket',
+        promise: makeRequest(
+          `http://127.0.0.1:${remote_debugging_port}/json/version`,
+          { json: true, maxAttempts: 120, retryDelay: 100, method: 'GET' },
+        ),
+      });
 
       debug('WS IS', get(data, 'webSocketDebuggerUrl', ''));
       this.is_active = true;
+      debug(`[timing] spawnBrowser total: ${Date.now() - spawnStart}ms`);
 
       return { wsUrl: get(data, 'webSocketDebuggerUrl', ''), resolution: this.resolution };
     }
 
+    debug(`[timing] spawnBrowser total: ${Date.now() - spawnStart}ms`);
+
     return '';
   }
 
@@ -1500,10 +1562,12 @@ export class GoLogin {
 
   async start() {
     // ensureSentryInitialized({ release: process.env.npm_package_version || '2.1.34' });
+    const startTotal = Date.now();
 
-    await this.createStartup();
-    const startResponse = await this.spawnBrowser();
+    await withTiming({ name: 'createStartup', promise: this.createStartup() });
+    const startResponse = await withTiming({ name: 'spawnBrowser', promise: this.spawnBrowser() });
     this.setActive(true);
+    debug(`[timing] start total: ${Date.now() - startTotal}ms`);
 
     return {
       status: 'success',
@@ -1513,11 +1577,14 @@ export class GoLogin {
   }
 
   async startLocal() {
-    await this.createStartup(true);
+    const startTotal = Date.now();
+
+    await withTiming({ name: 'createStartup', promise: this.createStartup(true) });
 
     // await this.createBrowserExtension();
-    const startResponse = await this.spawnBrowser();
+    const startResponse = await withTiming({ name: 'spawnBrowser', promise: this.spawnBrowser() });
     this.setActive(true);
+    debug(`[timing] startLocal total: ${Date.now() - startTotal}ms`);
 
     return { status: 'success', wsUrl: startResponse.wsUrl };
   }