@letsscrapedata/controller 0.0.46 → 0.0.47

package/dist/index.cjs

@@ -1214,8 +1214,11 @@ var PlaywrightBrowserContext = class extends import_node_events2.default {
   #browserIdx;
   #browserContextIdx;
   #browserContext;
+  #browserContextCreationMethod;
   #apiContext;
   #createTime;
+  #lastStatusUpdateTime;
+  #status;
   #incognito;
   #proxy;
   #maxPagesPerBrowserContext;
@@ -1241,7 +1244,7 @@ var PlaywrightBrowserContext = class extends import_node_events2.default {
       (0, import_utils3.loginfo)(`##browser  ${lsdPage.id()} ${openType}ed`);
     }
   }
-  constructor(lsdBrowser, browserContext, incognito = false, proxy = null, browserIdx = 0, browserContextIdx = 0, maxPagesPerBrowserContext = 20, maxPageFreeSeconds = 0, maxViewportOfNewPage = true) {
+  constructor(lsdBrowser, browserContext, browserContextCreationMethod, incognito = false, proxy = null, browserIdx = 0, browserContextIdx = 0, maxPagesPerBrowserContext = 20, maxPageFreeSeconds = 0, maxViewportOfNewPage = true) {
     if (!lsdBrowser || typeof lsdBrowser.browserContexts !== "function") {
       throw new Error(`Invalid lsdBrowser parameter`);
     }
@@ -1253,9 +1256,13 @@ var PlaywrightBrowserContext = class extends import_node_events2.default {
     this.#browserIdx = browserIdx;
     this.#browserContextIdx = browserContextIdx;
     this.#browserContext = browserContext;
+    this.#browserContextCreationMethod = browserContextCreationMethod;
     const apiRequestContext = browserContext.request;
     this.#apiContext = new PlaywrightApiContext(apiRequestContext);
-    this.#createTime = (0, import_utils3.getCurrentUnixTime)();
+    const currentTime = (0, import_utils3.getCurrentUnixTime)();
+    this.#createTime = currentTime;
+    this.#lastStatusUpdateTime = currentTime;
+    this.#status = "free";
     this.#incognito = incognito === false ? false : true;
     this.#proxy = proxy?.proxyUrl ? proxy : null;
     this.#maxPagesPerBrowserContext = maxPagesPerBrowserContext;
@@ -1271,8 +1278,8 @@ var PlaywrightBrowserContext = class extends import_node_events2.default {
         const { browserIdx: browserIdx2, browserContextIdx: browserContextIdx2, pageIdx } = pageInfo;
         (0, import_utils3.logwarn)(`##browser page-${browserIdx2}-${browserContextIdx2}-${pageIdx} has been already created`);
       } else {
-        const currentTime = (0, import_utils3.getCurrentUnixTime)();
-        const pageInfo2 = { browserIdx: this.#browserIdx, browserContextIdx: this.#browserContextIdx, pageIdx: this.#nextPageIdx++, openType: "other", openTime: currentTime, lastStatusUpdateTime: currentTime, taskId: 0, relatedId: 0, misc: {} };
+        const currentTime2 = (0, import_utils3.getCurrentUnixTime)();
+        const pageInfo2 = { browserIdx: this.#browserIdx, browserContextIdx: this.#browserContextIdx, pageIdx: this.#nextPageIdx++, openType: "other", openTime: currentTime2, lastStatusUpdateTime: currentTime2, taskId: 0, relatedId: 0, misc: {} };
         const lsdPage = new PlaywrightPage(this, page, pageInfo2);
         if (this.#maxViewportOfNewPage) {
           await lsdPage.maximizeViewport();
@@ -1309,7 +1316,10 @@ var PlaywrightBrowserContext = class extends import_node_events2.default {
   }
   async close() {
     if (this.#browserContext) {
+      this.#status = "closed";
+      this.#lastStatusUpdateTime = (0, import_utils3.getCurrentUnixTime)();
       await this.#browserContext.close();
+      (0, import_utils3.loginfo)(`browserContext ${this.id()} closed at ${this.#lastStatusUpdateTime}`);
     }
     return true;
   }
@@ -1361,6 +1371,9 @@ var PlaywrightBrowserContext = class extends import_node_events2.default {
       return false;
     }
   }
+  creationMethod() {
+    return this.#browserContextCreationMethod;
+  }
   doesMeetBrowserContextRequirements(browserContextRequirements) {
     if (!this.#lsdBrowser.doesMeetBrowserContextRequirements(browserContextRequirements)) {
       return false;
@@ -1410,6 +1423,15 @@ var PlaywrightBrowserContext = class extends import_node_events2.default {
       return null;
     }
   }
+  free() {
+    if (this.#status === "busy") {
+      this.#status = "free";
+      this.#lastStatusUpdateTime = (0, import_utils3.getCurrentUnixTime)();
+      return true;
+    } else {
+      return false;
+    }
+  }
   hasFreePage(pageNum = 1) {
     if (this.#maxPagesPerBrowserContext - this.#lsdPages.length > pageNum) {
       return true;
@@ -1477,6 +1499,18 @@ var PlaywrightBrowserContext = class extends import_node_events2.default {
       return false;
     }
   }
+  status() {
+    return this.#status;
+  }
+  use() {
+    if (this.#status === "free") {
+      this.#status = "busy";
+      this.#lastStatusUpdateTime = (0, import_utils3.getCurrentUnixTime)();
+      return true;
+    } else {
+      return false;
+    }
+  }
   _origBrowserContext() {
     return this.#browserContext;
   }
@@ -1488,6 +1522,7 @@ var PlaywrightBrowser = class extends import_node_events3.default {
   #browser;
   #browserIdx;
   #pid;
+  #createTime;
   #lsdBrowserContexts;
   #browserControllerType;
   #browserType;
@@ -1521,6 +1556,7 @@ var PlaywrightBrowser = class extends import_node_events3.default {
     this.#browser = browser;
     this.#browserIdx = browserIdx;
     this.#pid = pid;
+    this.#createTime = (0, import_utils4.getCurrentUnixTime)();
     this.#lsdBrowserContexts = [];
     this.#browserControllerType = "playwright";
     this.#browserType = browerType;
@@ -1538,7 +1574,7 @@ var PlaywrightBrowser = class extends import_node_events3.default {
     }
     const incognito = typeof options?.incognito === "boolean" ? options.incognito : true;
     for (const browserContext of browserContexts) {
-      const lsdBrowserContext = new PlaywrightBrowserContext(this, browserContext, incognito, this.#proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), maxViewportOfNewPage);
+      const lsdBrowserContext = new PlaywrightBrowserContext(this, browserContext, "launch", incognito, this.#proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), maxViewportOfNewPage);
       this.#lsdBrowserContexts.push(lsdBrowserContext);
       (0, import_utils4.loginfo)(`##browserContext  ${lsdBrowserContext.id()} ${this.#browserCreationMethod}ed`);
     }
@@ -1596,7 +1632,7 @@ var PlaywrightBrowser = class extends import_node_events3.default {
     }
     const browserContext = await this.#browser.newContext(browserContextOptions);
     const { maxViewportOfNewPage = this.#options.maxViewportOfNewPage } = options ? options : {};
-    const lsdBrowserContext = new PlaywrightBrowserContext(this, browserContext, true, proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), maxViewportOfNewPage);
+    const lsdBrowserContext = new PlaywrightBrowserContext(this, browserContext, "new", true, proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), maxViewportOfNewPage);
     this.#lsdBrowserContexts.push(lsdBrowserContext);
     (0, import_utils4.loginfo)(`##browser  ${lsdBrowserContext.id()} created`);
     return lsdBrowserContext;
@@ -1623,6 +1659,9 @@ var PlaywrightBrowser = class extends import_node_events3.default {
   browserType() {
     return this.#browserType;
   }
+  createTime() {
+    return this.#createTime;
+  }
   doesMeetBrowserContextRequirements(browserContextRequirements) {
     const { browserControllerTypes, browserTypes, browserHeadlesses } = browserContextRequirements;
     return (browserControllerTypes.length === 0 || browserControllerTypes.includes(this.#browserControllerType)) && (browserTypes.length === 0 || browserTypes.includes(this.#browserType)) && (browserHeadlesses.length === 0 || browserHeadlesses.includes(this.#headless));
@@ -2748,12 +2787,15 @@ var PuppeteerBrowserContext = class extends import_node_events5.default {
   #browserIdx;
   #browserContextIdx;
   #browserContext;
+  #browserContextCreationMethod;
   /**
    * the userAgent of pages in this browserContext if userAgent
    * * Notice: it is not the actual userAgent if !#userAgent (ignored if !#userAgent)
    */
   #userAgent;
   #createTime;
+  #lastStatusUpdateTime;
+  #status;
   #incognito;
   #proxy;
   #maxPagesPerBrowserContext;
@@ -2782,7 +2824,7 @@ var PuppeteerBrowserContext = class extends import_node_events5.default {
       (0, import_utils7.loginfo)(`##browser  ${lsdPage.id()} ${openType}ed`);
     }
   }
-  constructor(lsdBrowser, browserContext, incognito = false, proxy = null, browserIdx = 0, browserContextIdx = 0, maxPagesPerBrowserContext = 20, maxPageFreeSeconds = 0, userAgent = "", maxViewportOfNewPage = true) {
+  constructor(lsdBrowser, browserContext, browserContextCreationMethod, incognito = false, proxy = null, browserIdx = 0, browserContextIdx = 0, maxPagesPerBrowserContext = 20, maxPageFreeSeconds = 0, userAgent = "", maxViewportOfNewPage = true) {
     if (!lsdBrowser || typeof lsdBrowser.browserContexts !== "function") {
       throw new Error(`Invalid lsdBrowser parameter`);
     }
@@ -2794,8 +2836,12 @@ var PuppeteerBrowserContext = class extends import_node_events5.default {
     this.#browserIdx = browserIdx;
     this.#browserContextIdx = browserContextIdx;
     this.#browserContext = browserContext;
+    this.#browserContextCreationMethod = browserContextCreationMethod;
     this.#userAgent = userAgent;
-    this.#createTime = (0, import_utils7.getCurrentUnixTime)();
+    const currentTime = (0, import_utils7.getCurrentUnixTime)();
+    this.#createTime = currentTime;
+    this.#lastStatusUpdateTime = currentTime;
+    this.#status = "free";
     this.#incognito = incognito === false ? false : true;
     this.#proxy = proxy?.proxyUrl ? proxy : null;
     this.#maxPagesPerBrowserContext = maxPagesPerBrowserContext;
@@ -2816,8 +2862,8 @@ var PuppeteerBrowserContext = class extends import_node_events5.default {
           const { browserIdx: browserIdx2, browserContextIdx: browserContextIdx2, pageIdx } = pageInfo;
           (0, import_utils7.logwarn)(`##browser page-${browserIdx2}-${browserContextIdx2}-${pageIdx} has been already created`);
         } else {
-          const currentTime = (0, import_utils7.getCurrentUnixTime)();
-          const pageInfo2 = { browserIdx: this.#browserIdx, browserContextIdx: this.#browserContextIdx, pageIdx: this.#nextPageIdx++, openType: "other", openTime: currentTime, lastStatusUpdateTime: currentTime, taskId: 0, relatedId: 0, misc: {} };
+          const currentTime2 = (0, import_utils7.getCurrentUnixTime)();
+          const pageInfo2 = { browserIdx: this.#browserIdx, browserContextIdx: this.#browserContextIdx, pageIdx: this.#nextPageIdx++, openType: "other", openTime: currentTime2, lastStatusUpdateTime: currentTime2, taskId: 0, relatedId: 0, misc: {} };
           const lsdPage = new PuppeteerPage(this, page, pageInfo2);
           if (this.#maxViewportOfNewPage) {
             await lsdPage.maximizeViewport();
@@ -2847,6 +2893,15 @@ var PuppeteerBrowserContext = class extends import_node_events5.default {
       return;
     });
   }
+  free() {
+    if (this.#status === "busy") {
+      this.#status = "free";
+      this.#lastStatusUpdateTime = (0, import_utils7.getCurrentUnixTime)();
+      return true;
+    } else {
+      return false;
+    }
+  }
   apiContext() {
     throw new Error("Not supported in PuppeteerPage.");
   }
@@ -2855,7 +2910,10 @@ var PuppeteerBrowserContext = class extends import_node_events5.default {
   }
   async close() {
     if (this.#browserContext) {
+      this.#status = "closed";
+      this.#lastStatusUpdateTime = (0, import_utils7.getCurrentUnixTime)();
       await this.#browserContext.close();
+      (0, import_utils7.loginfo)(`browserContext ${this.id()} closed at ${this.#lastStatusUpdateTime}`);
     }
     return true;
   }
@@ -2907,6 +2965,9 @@ var PuppeteerBrowserContext = class extends import_node_events5.default {
       return false;
     }
   }
+  creationMethod() {
+    return this.#browserContextCreationMethod;
+  }
   doesMeetBrowserContextRequirements(browserContextRequirements) {
     if (!this.#lsdBrowser.doesMeetBrowserContextRequirements(browserContextRequirements)) {
       return false;
@@ -3025,6 +3086,18 @@ var PuppeteerBrowserContext = class extends import_node_events5.default {
       return false;
     }
   }
+  status() {
+    return this.#status;
+  }
+  use() {
+    if (this.#status === "free") {
+      this.#status = "busy";
+      this.#lastStatusUpdateTime = (0, import_utils7.getCurrentUnixTime)();
+      return true;
+    } else {
+      return false;
+    }
+  }
   _origBrowserContext() {
     return this.#browserContext;
   }
@@ -3036,6 +3109,7 @@ var PuppeteerBrowser = class extends import_node_events6.default {
   #browser;
   #browserIdx;
   #pid;
+  #createTime;
   #lsdBrowserContexts;
   #browserControllerType;
   #browserType;
@@ -3072,6 +3146,7 @@ var PuppeteerBrowser = class extends import_node_events6.default {
     this.#browser = browser;
     this.#browserIdx = browserIdx;
     this.#pid = pid;
+    this.#createTime = (0, import_utils8.getCurrentUnixTime)();
     this.#lsdBrowserContexts = [];
     this.#browserControllerType = "puppeteer";
     this.#browserType = browerType;
@@ -3086,7 +3161,7 @@ var PuppeteerBrowser = class extends import_node_events6.default {
     const browserContexts = browser.browserContexts();
     const incognito = typeof options?.incognito === "boolean" ? options.incognito : false;
     for (const browserContext of browserContexts) {
-      const lsdBrowserContext = new PuppeteerBrowserContext(this, browserContext, incognito, this.#proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), this.#userAgent(), maxViewportOfNewPage);
+      const lsdBrowserContext = new PuppeteerBrowserContext(this, browserContext, "launch", incognito, this.#proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), this.#userAgent(), maxViewportOfNewPage);
       this.#lsdBrowserContexts.push(lsdBrowserContext);
       (0, import_utils8.loginfo)(`##browser  ${lsdBrowserContext.id()} ${this.#browserCreationMethod}ed`);
     }
@@ -3138,7 +3213,7 @@ var PuppeteerBrowser = class extends import_node_events6.default {
     const browserContext = await this.#browser.createBrowserContext(browserContextOptions);
     const userAgent = options?.userAgent ? options.userAgent : "";
     const { maxViewportOfNewPage = this.#options.maxViewportOfNewPage } = options ? options : {};
-    const lsdBrowserContext = new PuppeteerBrowserContext(this, browserContext, true, proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), userAgent, maxViewportOfNewPage);
+    const lsdBrowserContext = new PuppeteerBrowserContext(this, browserContext, "new", true, proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), userAgent, maxViewportOfNewPage);
     this.#lsdBrowserContexts.push(lsdBrowserContext);
     (0, import_utils8.loginfo)(`##browser  ${lsdBrowserContext.id()} created`);
     return lsdBrowserContext;
@@ -3167,6 +3242,9 @@ var PuppeteerBrowser = class extends import_node_events6.default {
   browserType() {
     return this.#browserType;
   }
+  createTime() {
+    return this.#createTime;
+  }
   doesMeetBrowserContextRequirements(browserContextRequirements) {
     const { browserControllerTypes, browserTypes, browserHeadlesses } = browserContextRequirements;
     return (browserControllerTypes.length === 0 || browserControllerTypes.includes(this.#browserControllerType)) && (browserTypes.length === 0 || browserTypes.includes(this.#browserType)) && (browserHeadlesses.length === 0 || browserHeadlesses.includes(this.#headless));

package/dist/index.d.cts

@@ -12,6 +12,8 @@ type AllApiRequestContext = APIRequestContext;
 type CheerioNode = cheerio.Cheerio;
 type BrowserControllerType = "puppeteer" | "playwright";
 type BrowserCreationMethod = "launch" | "connect";
+type BrowserContextCreationMethod = "launch" | "new";
+type BrowserContextStatus = "free" | "busy" | "closed";
 type LsdBrowserType = "chromium" | "firefox" | "webkit";
 interface BrowserContextRequirements {
     browserControllerTypes: BrowserControllerType[];
@@ -992,6 +994,10 @@ interface LsdBrowserContext extends EventEmitter {
      * @param browserContextRequirements
      */
     doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
+    /**
+     * Free a busy LsdBrowserContext.
+     */
+    free(): boolean;
     /**
      * get a free page from current pages or by creating a new page
      */
@@ -1004,10 +1010,16 @@ interface LsdBrowserContext extends EventEmitter {
     hasFreePage(pageNum?: number): boolean;
     id(): string;
     isIncognito(): boolean;
+    creationMethod(): BrowserContextCreationMethod;
     page(pageIdx: number): LsdPage | null;
     pages(): LsdPage[];
     proxy(): ProxyInController | null;
     setStateData(stateData: BrowserStateData): Promise<boolean>;
+    status(): BrowserContextStatus;
+    /**
+     * start to use this LsdBrowserContext
+     */
+    use(): boolean;
     _origBrowserContext(): AllBrowserContext;
 }
 interface LsdBrowser extends EventEmitter {
@@ -1023,6 +1035,7 @@ interface LsdBrowser extends EventEmitter {
     browserControllerType(): BrowserControllerType;
     browserCreationMethod(): BrowserCreationMethod;
     browserType(): LsdBrowserType;
+    createTime(): number;
     /**
      * doest this browser meet browserContextRequirements (incognitos ignored in browser)?
      * @param browserContextRequirements
@@ -1097,6 +1110,7 @@ declare class PlaywrightBrowser extends EventEmitter implements LsdBrowser {
     browserControllerType(): BrowserControllerType;
     browserCreationMethod(): BrowserCreationMethod;
     browserType(): LsdBrowserType;
+    createTime(): number;
     doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     executablePath(): string;
     id(): string;
@@ -1115,13 +1129,15 @@ declare class PlaywrightBrowser extends EventEmitter implements LsdBrowser {
 
 declare class PlaywrightBrowserContext extends EventEmitter implements LsdBrowserContext {
     #private;
-    constructor(lsdBrowser: LsdBrowser, browserContext: BrowserContext, incognito?: boolean, proxy?: ProxyInController | null, browserIdx?: number, browserContextIdx?: number, maxPagesPerBrowserContext?: number, maxPageFreeSeconds?: number, maxViewportOfNewPage?: boolean);
+    constructor(lsdBrowser: LsdBrowser, browserContext: BrowserContext, browserContextCreationMethod: BrowserContextCreationMethod, incognito?: boolean, proxy?: ProxyInController | null, browserIdx?: number, browserContextIdx?: number, maxPagesPerBrowserContext?: number, maxPageFreeSeconds?: number, maxViewportOfNewPage?: boolean);
     apiContext(): LsdApiContext;
     browser(): LsdBrowser;
     close(): Promise<boolean>;
     closeFreePages(maxPageFreeSeconds?: number): Promise<boolean>;
+    creationMethod(): BrowserContextCreationMethod;
     doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     getPage(always?: boolean): Promise<LsdPage | null>;
+    free(): boolean;
     hasFreePage(pageNum?: number): boolean;
     id(): string;
     isIncognito(): boolean;
@@ -1129,6 +1145,8 @@ declare class PlaywrightBrowserContext extends EventEmitter implements LsdBrowse
     pages(): LsdPage[];
     proxy(): ProxyInController | null;
     setStateData(stateData: BrowserStateData): Promise<boolean>;
+    status(): BrowserContextStatus;
+    use(): boolean;
     _origBrowserContext(): AllBrowserContext;
 }
 
@@ -1219,6 +1237,7 @@ declare class PuppeteerBrowser extends EventEmitter implements LsdBrowser {
     browserControllerType(): BrowserControllerType;
     browserCreationMethod(): BrowserCreationMethod;
     browserType(): LsdBrowserType;
+    createTime(): number;
     doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     executablePath(): string;
     id(): string;
@@ -1237,11 +1256,13 @@ declare class PuppeteerBrowser extends EventEmitter implements LsdBrowser {
 
 declare class PuppeteerBrowserContext extends EventEmitter implements LsdBrowserContext {
     #private;
-    constructor(lsdBrowser: LsdBrowser, browserContext: BrowserContext$1, incognito?: boolean, proxy?: ProxyInController | null, browserIdx?: number, browserContextIdx?: number, maxPagesPerBrowserContext?: number, maxPageFreeSeconds?: number, userAgent?: string, maxViewportOfNewPage?: boolean);
+    constructor(lsdBrowser: LsdBrowser, browserContext: BrowserContext$1, browserContextCreationMethod: BrowserContextCreationMethod, incognito?: boolean, proxy?: ProxyInController | null, browserIdx?: number, browserContextIdx?: number, maxPagesPerBrowserContext?: number, maxPageFreeSeconds?: number, userAgent?: string, maxViewportOfNewPage?: boolean);
+    free(): boolean;
     apiContext(): LsdApiContext;
     browser(): LsdBrowser;
     close(): Promise<boolean>;
     closeFreePages(maxPageFreeSeconds?: number): Promise<boolean>;
+    creationMethod(): BrowserContextCreationMethod;
     doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     getPage(always?: boolean): Promise<LsdPage | null>;
     hasFreePage(pageNum?: number): boolean;
@@ -1251,6 +1272,8 @@ declare class PuppeteerBrowserContext extends EventEmitter implements LsdBrowser
     pages(): LsdPage[];
     proxy(): ProxyInController | null;
     setStateData(stateData: BrowserStateData): Promise<boolean>;
+    status(): BrowserContextStatus;
+    use(): boolean;
     _origBrowserContext(): AllBrowserContext;
 }
 
@@ -1425,4 +1448,4 @@ declare class LsdBrowserController implements LsdBrowserController$1 {
 }
 declare const controller: LsdBrowserController;
 
-export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllElement, type AllFrame, type AllPage, type AllResponse, type BrowserContextRequirements, type BrowserControllerType, type BrowserCreationMethod, type BrowserLaunchMethod, type BrowserStateData, CheerioElement, type CheerioNode, CheerioPage, type ClientCertificate, type CookieItem, type GotoOptions, type IframeOption, type InputOptions, type KeyInput, type KeyPressOptions, type LocalStorageItem, type LocalStorageOrigin, type LowerCasePaperFormat, type LsdApiContext, type LsdApiContextOptions, type LsdApiResponse, type LsdBrowser, type LsdBrowserContext, type LsdBrowserContextOptions, type LsdBrowserController$1 as LsdBrowserController, type LsdBrowserType, type LsdConnectOptions, type LsdElement, type LsdFetchOptions, type LsdLaunchOptions, type LsdPage, type MouseClickOptions, type MouseClickType, type NavigationWaitUntil, type PDFMargin, type PDFOptions, type PageEvent, type PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageOpenType, type PageStatus, type PaperFormat, PlaywrightBrowser, PlaywrightBrowserContext, type PlaywrightBrowserTypes, PlaywrightElement, PlaywrightPage, type ProxyInController, PuppeteerBrowser, PuppeteerBrowserContext, PuppeteerElement, PuppeteerPage, type RequestInterceptionAction, type RequestInterceptionOption, type RequestMatch, type RequestMethod, type RequestResourceType, type ResponseHandler, type ResponseHandlerOptions, type ResponseInterceptionItem, type ResponseInterceptionOption, type ResponseMatch, type ResponsePageData, type ScreenshotOptions, type SelectOptions, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller };
+export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllElement, type AllFrame, type AllPage, type AllResponse, type BrowserContextCreationMethod, type BrowserContextRequirements, type BrowserContextStatus, type BrowserControllerType, type BrowserCreationMethod, type BrowserLaunchMethod, type BrowserStateData, CheerioElement, type CheerioNode, CheerioPage, type ClientCertificate, type CookieItem, type GotoOptions, type IframeOption, type InputOptions, type KeyInput, type KeyPressOptions, type LocalStorageItem, type LocalStorageOrigin, type LowerCasePaperFormat, type LsdApiContext, type LsdApiContextOptions, type LsdApiResponse, type LsdBrowser, type LsdBrowserContext, type LsdBrowserContextOptions, type LsdBrowserController$1 as LsdBrowserController, type LsdBrowserType, type LsdConnectOptions, type LsdElement, type LsdFetchOptions, type LsdLaunchOptions, type LsdPage, type MouseClickOptions, type MouseClickType, type NavigationWaitUntil, type PDFMargin, type PDFOptions, type PageEvent, type PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageOpenType, type PageStatus, type PaperFormat, PlaywrightBrowser, PlaywrightBrowserContext, type PlaywrightBrowserTypes, PlaywrightElement, PlaywrightPage, type ProxyInController, PuppeteerBrowser, PuppeteerBrowserContext, PuppeteerElement, PuppeteerPage, type RequestInterceptionAction, type RequestInterceptionOption, type RequestMatch, type RequestMethod, type RequestResourceType, type ResponseHandler, type ResponseHandlerOptions, type ResponseInterceptionItem, type ResponseInterceptionOption, type ResponseMatch, type ResponsePageData, type ScreenshotOptions, type SelectOptions, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller };

package/dist/index.d.ts

@@ -12,6 +12,8 @@ type AllApiRequestContext = APIRequestContext;
 type CheerioNode = cheerio.Cheerio;
 type BrowserControllerType = "puppeteer" | "playwright";
 type BrowserCreationMethod = "launch" | "connect";
+type BrowserContextCreationMethod = "launch" | "new";
+type BrowserContextStatus = "free" | "busy" | "closed";
 type LsdBrowserType = "chromium" | "firefox" | "webkit";
 interface BrowserContextRequirements {
     browserControllerTypes: BrowserControllerType[];
@@ -992,6 +994,10 @@ interface LsdBrowserContext extends EventEmitter {
      * @param browserContextRequirements
      */
     doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
+    /**
+     * Free a busy LsdBrowserContext.
+     */
+    free(): boolean;
     /**
      * get a free page from current pages or by creating a new page
      */
@@ -1004,10 +1010,16 @@ interface LsdBrowserContext extends EventEmitter {
     hasFreePage(pageNum?: number): boolean;
     id(): string;
     isIncognito(): boolean;
+    creationMethod(): BrowserContextCreationMethod;
     page(pageIdx: number): LsdPage | null;
     pages(): LsdPage[];
     proxy(): ProxyInController | null;
     setStateData(stateData: BrowserStateData): Promise<boolean>;
+    status(): BrowserContextStatus;
+    /**
+     * start to use this LsdBrowserContext
+     */
+    use(): boolean;
     _origBrowserContext(): AllBrowserContext;
 }
 interface LsdBrowser extends EventEmitter {
@@ -1023,6 +1035,7 @@ interface LsdBrowser extends EventEmitter {
     browserControllerType(): BrowserControllerType;
     browserCreationMethod(): BrowserCreationMethod;
     browserType(): LsdBrowserType;
+    createTime(): number;
     /**
      * doest this browser meet browserContextRequirements (incognitos ignored in browser)?
      * @param browserContextRequirements
@@ -1097,6 +1110,7 @@ declare class PlaywrightBrowser extends EventEmitter implements LsdBrowser {
     browserControllerType(): BrowserControllerType;
     browserCreationMethod(): BrowserCreationMethod;
     browserType(): LsdBrowserType;
+    createTime(): number;
     doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     executablePath(): string;
     id(): string;
@@ -1115,13 +1129,15 @@ declare class PlaywrightBrowser extends EventEmitter implements LsdBrowser {
 
 declare class PlaywrightBrowserContext extends EventEmitter implements LsdBrowserContext {
     #private;
-    constructor(lsdBrowser: LsdBrowser, browserContext: BrowserContext, incognito?: boolean, proxy?: ProxyInController | null, browserIdx?: number, browserContextIdx?: number, maxPagesPerBrowserContext?: number, maxPageFreeSeconds?: number, maxViewportOfNewPage?: boolean);
+    constructor(lsdBrowser: LsdBrowser, browserContext: BrowserContext, browserContextCreationMethod: BrowserContextCreationMethod, incognito?: boolean, proxy?: ProxyInController | null, browserIdx?: number, browserContextIdx?: number, maxPagesPerBrowserContext?: number, maxPageFreeSeconds?: number, maxViewportOfNewPage?: boolean);
     apiContext(): LsdApiContext;
     browser(): LsdBrowser;
     close(): Promise<boolean>;
     closeFreePages(maxPageFreeSeconds?: number): Promise<boolean>;
+    creationMethod(): BrowserContextCreationMethod;
     doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     getPage(always?: boolean): Promise<LsdPage | null>;
+    free(): boolean;
     hasFreePage(pageNum?: number): boolean;
     id(): string;
     isIncognito(): boolean;
@@ -1129,6 +1145,8 @@ declare class PlaywrightBrowserContext extends EventEmitter implements LsdBrowse
     pages(): LsdPage[];
     proxy(): ProxyInController | null;
     setStateData(stateData: BrowserStateData): Promise<boolean>;
+    status(): BrowserContextStatus;
+    use(): boolean;
     _origBrowserContext(): AllBrowserContext;
 }
 
@@ -1219,6 +1237,7 @@ declare class PuppeteerBrowser extends EventEmitter implements LsdBrowser {
     browserControllerType(): BrowserControllerType;
     browserCreationMethod(): BrowserCreationMethod;
     browserType(): LsdBrowserType;
+    createTime(): number;
     doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     executablePath(): string;
     id(): string;
@@ -1237,11 +1256,13 @@ declare class PuppeteerBrowser extends EventEmitter implements LsdBrowser {
 
 declare class PuppeteerBrowserContext extends EventEmitter implements LsdBrowserContext {
     #private;
-    constructor(lsdBrowser: LsdBrowser, browserContext: BrowserContext$1, incognito?: boolean, proxy?: ProxyInController | null, browserIdx?: number, browserContextIdx?: number, maxPagesPerBrowserContext?: number, maxPageFreeSeconds?: number, userAgent?: string, maxViewportOfNewPage?: boolean);
+    constructor(lsdBrowser: LsdBrowser, browserContext: BrowserContext$1, browserContextCreationMethod: BrowserContextCreationMethod, incognito?: boolean, proxy?: ProxyInController | null, browserIdx?: number, browserContextIdx?: number, maxPagesPerBrowserContext?: number, maxPageFreeSeconds?: number, userAgent?: string, maxViewportOfNewPage?: boolean);
+    free(): boolean;
     apiContext(): LsdApiContext;
     browser(): LsdBrowser;
     close(): Promise<boolean>;
     closeFreePages(maxPageFreeSeconds?: number): Promise<boolean>;
+    creationMethod(): BrowserContextCreationMethod;
     doesMeetBrowserContextRequirements(browserContextRequirements: BrowserContextRequirements): boolean;
     getPage(always?: boolean): Promise<LsdPage | null>;
     hasFreePage(pageNum?: number): boolean;
@@ -1251,6 +1272,8 @@ declare class PuppeteerBrowserContext extends EventEmitter implements LsdBrowser
     pages(): LsdPage[];
     proxy(): ProxyInController | null;
     setStateData(stateData: BrowserStateData): Promise<boolean>;
+    status(): BrowserContextStatus;
+    use(): boolean;
     _origBrowserContext(): AllBrowserContext;
 }
 
@@ -1425,4 +1448,4 @@ declare class LsdBrowserController implements LsdBrowserController$1 {
 }
 declare const controller: LsdBrowserController;
 
-export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllElement, type AllFrame, type AllPage, type AllResponse, type BrowserContextRequirements, type BrowserControllerType, type BrowserCreationMethod, type BrowserLaunchMethod, type BrowserStateData, CheerioElement, type CheerioNode, CheerioPage, type ClientCertificate, type CookieItem, type GotoOptions, type IframeOption, type InputOptions, type KeyInput, type KeyPressOptions, type LocalStorageItem, type LocalStorageOrigin, type LowerCasePaperFormat, type LsdApiContext, type LsdApiContextOptions, type LsdApiResponse, type LsdBrowser, type LsdBrowserContext, type LsdBrowserContextOptions, type LsdBrowserController$1 as LsdBrowserController, type LsdBrowserType, type LsdConnectOptions, type LsdElement, type LsdFetchOptions, type LsdLaunchOptions, type LsdPage, type MouseClickOptions, type MouseClickType, type NavigationWaitUntil, type PDFMargin, type PDFOptions, type PageEvent, type PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageOpenType, type PageStatus, type PaperFormat, PlaywrightBrowser, PlaywrightBrowserContext, type PlaywrightBrowserTypes, PlaywrightElement, PlaywrightPage, type ProxyInController, PuppeteerBrowser, PuppeteerBrowserContext, PuppeteerElement, PuppeteerPage, type RequestInterceptionAction, type RequestInterceptionOption, type RequestMatch, type RequestMethod, type RequestResourceType, type ResponseHandler, type ResponseHandlerOptions, type ResponseInterceptionItem, type ResponseInterceptionOption, type ResponseMatch, type ResponsePageData, type ScreenshotOptions, type SelectOptions, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller };
+export { type AllApiRequestContext, type AllBrowser, type AllBrowserContext, type AllElement, type AllFrame, type AllPage, type AllResponse, type BrowserContextCreationMethod, type BrowserContextRequirements, type BrowserContextStatus, type BrowserControllerType, type BrowserCreationMethod, type BrowserLaunchMethod, type BrowserStateData, CheerioElement, type CheerioNode, CheerioPage, type ClientCertificate, type CookieItem, type GotoOptions, type IframeOption, type InputOptions, type KeyInput, type KeyPressOptions, type LocalStorageItem, type LocalStorageOrigin, type LowerCasePaperFormat, type LsdApiContext, type LsdApiContextOptions, type LsdApiResponse, type LsdBrowser, type LsdBrowserContext, type LsdBrowserContextOptions, type LsdBrowserController$1 as LsdBrowserController, type LsdBrowserType, type LsdConnectOptions, type LsdElement, type LsdFetchOptions, type LsdLaunchOptions, type LsdPage, type MouseClickOptions, type MouseClickType, type NavigationWaitUntil, type PDFMargin, type PDFOptions, type PageEvent, type PageExtInPlaywright, type PageExtInPuppeteer, type PageInfo, type PageOpenType, type PageStatus, type PaperFormat, PlaywrightBrowser, PlaywrightBrowserContext, type PlaywrightBrowserTypes, PlaywrightElement, PlaywrightPage, type ProxyInController, PuppeteerBrowser, PuppeteerBrowserContext, PuppeteerElement, PuppeteerPage, type RequestInterceptionAction, type RequestInterceptionOption, type RequestMatch, type RequestMethod, type RequestResourceType, type ResponseHandler, type ResponseHandlerOptions, type ResponseInterceptionItem, type ResponseInterceptionOption, type ResponseMatch, type ResponsePageData, type ScreenshotOptions, type SelectOptions, type UpdatablePageInfo, type ViewportSize, type WaitElementOptions, type WaitElementState, type WaitNavigationOptions, controller };

package/dist/index.js

@@ -1168,8 +1168,11 @@ var PlaywrightBrowserContext = class extends EventEmitter2 {
   #browserIdx;
   #browserContextIdx;
   #browserContext;
+  #browserContextCreationMethod;
   #apiContext;
   #createTime;
+  #lastStatusUpdateTime;
+  #status;
   #incognito;
   #proxy;
   #maxPagesPerBrowserContext;
@@ -1195,7 +1198,7 @@ var PlaywrightBrowserContext = class extends EventEmitter2 {
       loginfo3(`##browser  ${lsdPage.id()} ${openType}ed`);
     }
   }
-  constructor(lsdBrowser, browserContext, incognito = false, proxy = null, browserIdx = 0, browserContextIdx = 0, maxPagesPerBrowserContext = 20, maxPageFreeSeconds = 0, maxViewportOfNewPage = true) {
+  constructor(lsdBrowser, browserContext, browserContextCreationMethod, incognito = false, proxy = null, browserIdx = 0, browserContextIdx = 0, maxPagesPerBrowserContext = 20, maxPageFreeSeconds = 0, maxViewportOfNewPage = true) {
     if (!lsdBrowser || typeof lsdBrowser.browserContexts !== "function") {
       throw new Error(`Invalid lsdBrowser parameter`);
     }
@@ -1207,9 +1210,13 @@ var PlaywrightBrowserContext = class extends EventEmitter2 {
     this.#browserIdx = browserIdx;
     this.#browserContextIdx = browserContextIdx;
     this.#browserContext = browserContext;
+    this.#browserContextCreationMethod = browserContextCreationMethod;
     const apiRequestContext = browserContext.request;
     this.#apiContext = new PlaywrightApiContext(apiRequestContext);
-    this.#createTime = getCurrentUnixTime2();
+    const currentTime = getCurrentUnixTime2();
+    this.#createTime = currentTime;
+    this.#lastStatusUpdateTime = currentTime;
+    this.#status = "free";
     this.#incognito = incognito === false ? false : true;
     this.#proxy = proxy?.proxyUrl ? proxy : null;
     this.#maxPagesPerBrowserContext = maxPagesPerBrowserContext;
@@ -1225,8 +1232,8 @@ var PlaywrightBrowserContext = class extends EventEmitter2 {
         const { browserIdx: browserIdx2, browserContextIdx: browserContextIdx2, pageIdx } = pageInfo;
         logwarn2(`##browser page-${browserIdx2}-${browserContextIdx2}-${pageIdx} has been already created`);
       } else {
-        const currentTime = getCurrentUnixTime2();
-        const pageInfo2 = { browserIdx: this.#browserIdx, browserContextIdx: this.#browserContextIdx, pageIdx: this.#nextPageIdx++, openType: "other", openTime: currentTime, lastStatusUpdateTime: currentTime, taskId: 0, relatedId: 0, misc: {} };
+        const currentTime2 = getCurrentUnixTime2();
+        const pageInfo2 = { browserIdx: this.#browserIdx, browserContextIdx: this.#browserContextIdx, pageIdx: this.#nextPageIdx++, openType: "other", openTime: currentTime2, lastStatusUpdateTime: currentTime2, taskId: 0, relatedId: 0, misc: {} };
         const lsdPage = new PlaywrightPage(this, page, pageInfo2);
         if (this.#maxViewportOfNewPage) {
           await lsdPage.maximizeViewport();
@@ -1263,7 +1270,10 @@ var PlaywrightBrowserContext = class extends EventEmitter2 {
   }
   async close() {
     if (this.#browserContext) {
+      this.#status = "closed";
+      this.#lastStatusUpdateTime = getCurrentUnixTime2();
       await this.#browserContext.close();
+      loginfo3(`browserContext ${this.id()} closed at ${this.#lastStatusUpdateTime}`);
     }
     return true;
   }
@@ -1315,6 +1325,9 @@ var PlaywrightBrowserContext = class extends EventEmitter2 {
       return false;
     }
   }
+  creationMethod() {
+    return this.#browserContextCreationMethod;
+  }
   doesMeetBrowserContextRequirements(browserContextRequirements) {
     if (!this.#lsdBrowser.doesMeetBrowserContextRequirements(browserContextRequirements)) {
       return false;
@@ -1364,6 +1377,15 @@ var PlaywrightBrowserContext = class extends EventEmitter2 {
       return null;
     }
   }
+  free() {
+    if (this.#status === "busy") {
+      this.#status = "free";
+      this.#lastStatusUpdateTime = getCurrentUnixTime2();
+      return true;
+    } else {
+      return false;
+    }
+  }
   hasFreePage(pageNum = 1) {
     if (this.#maxPagesPerBrowserContext - this.#lsdPages.length > pageNum) {
       return true;
@@ -1431,17 +1453,30 @@ var PlaywrightBrowserContext = class extends EventEmitter2 {
       return false;
     }
   }
+  status() {
+    return this.#status;
+  }
+  use() {
+    if (this.#status === "free") {
+      this.#status = "busy";
+      this.#lastStatusUpdateTime = getCurrentUnixTime2();
+      return true;
+    } else {
+      return false;
+    }
+  }
   _origBrowserContext() {
     return this.#browserContext;
   }
 };
 
 // src/playwright/browser.ts
-import { getPerformanceOfPidTree, logerr as logerr3, loginfo as loginfo4, logwarn as logwarn3 } from "@letsscrapedata/utils";
+import { getCurrentUnixTime as getCurrentUnixTime3, getPerformanceOfPidTree, logerr as logerr3, loginfo as loginfo4, logwarn as logwarn3 } from "@letsscrapedata/utils";
 var PlaywrightBrowser = class extends EventEmitter3 {
   #browser;
   #browserIdx;
   #pid;
+  #createTime;
   #lsdBrowserContexts;
   #browserControllerType;
   #browserType;
@@ -1475,6 +1510,7 @@ var PlaywrightBrowser = class extends EventEmitter3 {
     this.#browser = browser;
     this.#browserIdx = browserIdx;
     this.#pid = pid;
+    this.#createTime = getCurrentUnixTime3();
     this.#lsdBrowserContexts = [];
     this.#browserControllerType = "playwright";
     this.#browserType = browerType;
@@ -1492,7 +1528,7 @@ var PlaywrightBrowser = class extends EventEmitter3 {
     }
     const incognito = typeof options?.incognito === "boolean" ? options.incognito : true;
     for (const browserContext of browserContexts) {
-      const lsdBrowserContext = new PlaywrightBrowserContext(this, browserContext, incognito, this.#proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), maxViewportOfNewPage);
+      const lsdBrowserContext = new PlaywrightBrowserContext(this, browserContext, "launch", incognito, this.#proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), maxViewportOfNewPage);
       this.#lsdBrowserContexts.push(lsdBrowserContext);
       loginfo4(`##browserContext  ${lsdBrowserContext.id()} ${this.#browserCreationMethod}ed`);
     }
@@ -1550,7 +1586,7 @@ var PlaywrightBrowser = class extends EventEmitter3 {
     }
     const browserContext = await this.#browser.newContext(browserContextOptions);
     const { maxViewportOfNewPage = this.#options.maxViewportOfNewPage } = options ? options : {};
-    const lsdBrowserContext = new PlaywrightBrowserContext(this, browserContext, true, proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), maxViewportOfNewPage);
+    const lsdBrowserContext = new PlaywrightBrowserContext(this, browserContext, "new", true, proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), maxViewportOfNewPage);
     this.#lsdBrowserContexts.push(lsdBrowserContext);
     loginfo4(`##browser  ${lsdBrowserContext.id()} created`);
     return lsdBrowserContext;
@@ -1577,6 +1613,9 @@ var PlaywrightBrowser = class extends EventEmitter3 {
   browserType() {
     return this.#browserType;
   }
+  createTime() {
+    return this.#createTime;
+  }
   doesMeetBrowserContextRequirements(browserContextRequirements) {
     const { browserControllerTypes, browserTypes, browserHeadlesses } = browserContextRequirements;
     return (browserControllerTypes.length === 0 || browserControllerTypes.includes(this.#browserControllerType)) && (browserTypes.length === 0 || browserTypes.includes(this.#browserType)) && (browserHeadlesses.length === 0 || browserHeadlesses.includes(this.#headless));
@@ -1900,7 +1939,7 @@ var PuppeteerElement = class _PuppeteerElement {
 };
 
 // src/puppeteer/page.ts
-import { getCurrentUnixTime as getCurrentUnixTime3, logerr as logerr5, loginfo as loginfo5, unreachable as unreachable4 } from "@letsscrapedata/utils";
+import { getCurrentUnixTime as getCurrentUnixTime4, logerr as logerr5, loginfo as loginfo5, unreachable as unreachable4 } from "@letsscrapedata/utils";
 var PuppeteerPage = class extends EventEmitter4 {
   #lsdBrowserContext;
   #page;
@@ -2098,7 +2137,7 @@ var PuppeteerPage = class extends EventEmitter4 {
     this.#lsdBrowserContext = browserContext;
     this.#page = page;
     this.#status = "free";
-    const currentTime = getCurrentUnixTime3();
+    const currentTime = getCurrentUnixTime4();
     const { browserIdx = 0, browserContextIdx = 0, pageIdx = 0, openType = "other", openTime = currentTime, lastStatusUpdateTime = currentTime, taskId = 0, relatedId = 0, misc = {} } = pageInfo ? pageInfo : {};
     this.#page.pageInfo = { browserIdx, browserContextIdx, pageIdx, openType, openTime, lastStatusUpdateTime, taskId, relatedId, misc };
     this.#pageId = `page-${browserIdx}-${browserContextIdx}-${pageIdx}`;
@@ -2696,18 +2735,21 @@ var PuppeteerPage = class extends EventEmitter4 {
 };
 
 // src/puppeteer/context.ts
-import { getCurrentUnixTime as getCurrentUnixTime4, logerr as logerr6, loginfo as loginfo6, logwarn as logwarn4, sleep as sleep2 } from "@letsscrapedata/utils";
+import { getCurrentUnixTime as getCurrentUnixTime5, logerr as logerr6, loginfo as loginfo6, logwarn as logwarn4, sleep as sleep2 } from "@letsscrapedata/utils";
 var PuppeteerBrowserContext = class extends EventEmitter5 {
   #lsdBrowser;
   #browserIdx;
   #browserContextIdx;
   #browserContext;
+  #browserContextCreationMethod;
   /**
    * the userAgent of pages in this browserContext if userAgent
    * * Notice: it is not the actual userAgent if !#userAgent (ignored if !#userAgent)
    */
   #userAgent;
   #createTime;
+  #lastStatusUpdateTime;
+  #status;
   #incognito;
   #proxy;
   #maxPagesPerBrowserContext;
@@ -2722,7 +2764,7 @@ var PuppeteerBrowserContext = class extends EventEmitter5 {
     }
     const pages = await this.#browserContext.pages();
     const openType = this.#lsdBrowser.browserCreationMethod();
-    const lastStatusUpdateTime = getCurrentUnixTime4();
+    const lastStatusUpdateTime = getCurrentUnixTime5();
     for (const page of pages) {
       const pageInfo = { browserIdx: this.#browserIdx, browserContextIdx: this.#browserContextIdx, pageIdx: this.#nextPageIdx++, openType, openTime: this.#createTime, lastStatusUpdateTime, taskId: 0, relatedId: 0, misc: {} };
       const lsdPage = new PuppeteerPage(this, page, pageInfo);
@@ -2736,7 +2778,7 @@ var PuppeteerBrowserContext = class extends EventEmitter5 {
       loginfo6(`##browser  ${lsdPage.id()} ${openType}ed`);
     }
   }
-  constructor(lsdBrowser, browserContext, incognito = false, proxy = null, browserIdx = 0, browserContextIdx = 0, maxPagesPerBrowserContext = 20, maxPageFreeSeconds = 0, userAgent = "", maxViewportOfNewPage = true) {
+  constructor(lsdBrowser, browserContext, browserContextCreationMethod, incognito = false, proxy = null, browserIdx = 0, browserContextIdx = 0, maxPagesPerBrowserContext = 20, maxPageFreeSeconds = 0, userAgent = "", maxViewportOfNewPage = true) {
     if (!lsdBrowser || typeof lsdBrowser.browserContexts !== "function") {
       throw new Error(`Invalid lsdBrowser parameter`);
     }
@@ -2748,8 +2790,12 @@ var PuppeteerBrowserContext = class extends EventEmitter5 {
     this.#browserIdx = browserIdx;
     this.#browserContextIdx = browserContextIdx;
     this.#browserContext = browserContext;
+    this.#browserContextCreationMethod = browserContextCreationMethod;
     this.#userAgent = userAgent;
-    this.#createTime = getCurrentUnixTime4();
+    const currentTime = getCurrentUnixTime5();
+    this.#createTime = currentTime;
+    this.#lastStatusUpdateTime = currentTime;
+    this.#status = "free";
     this.#incognito = incognito === false ? false : true;
     this.#proxy = proxy?.proxyUrl ? proxy : null;
     this.#maxPagesPerBrowserContext = maxPagesPerBrowserContext;
@@ -2770,8 +2816,8 @@ var PuppeteerBrowserContext = class extends EventEmitter5 {
           const { browserIdx: browserIdx2, browserContextIdx: browserContextIdx2, pageIdx } = pageInfo;
           logwarn4(`##browser page-${browserIdx2}-${browserContextIdx2}-${pageIdx} has been already created`);
         } else {
-          const currentTime = getCurrentUnixTime4();
-          const pageInfo2 = { browserIdx: this.#browserIdx, browserContextIdx: this.#browserContextIdx, pageIdx: this.#nextPageIdx++, openType: "other", openTime: currentTime, lastStatusUpdateTime: currentTime, taskId: 0, relatedId: 0, misc: {} };
+          const currentTime2 = getCurrentUnixTime5();
+          const pageInfo2 = { browserIdx: this.#browserIdx, browserContextIdx: this.#browserContextIdx, pageIdx: this.#nextPageIdx++, openType: "other", openTime: currentTime2, lastStatusUpdateTime: currentTime2, taskId: 0, relatedId: 0, misc: {} };
           const lsdPage = new PuppeteerPage(this, page, pageInfo2);
           if (this.#maxViewportOfNewPage) {
             await lsdPage.maximizeViewport();
@@ -2801,6 +2847,15 @@ var PuppeteerBrowserContext = class extends EventEmitter5 {
       return;
     });
   }
+  free() {
+    if (this.#status === "busy") {
+      this.#status = "free";
+      this.#lastStatusUpdateTime = getCurrentUnixTime5();
+      return true;
+    } else {
+      return false;
+    }
+  }
   apiContext() {
     throw new Error("Not supported in PuppeteerPage.");
   }
@@ -2809,7 +2864,10 @@ var PuppeteerBrowserContext = class extends EventEmitter5 {
   }
   async close() {
     if (this.#browserContext) {
+      this.#status = "closed";
+      this.#lastStatusUpdateTime = getCurrentUnixTime5();
       await this.#browserContext.close();
+      loginfo6(`browserContext ${this.id()} closed at ${this.#lastStatusUpdateTime}`);
     }
     return true;
   }
@@ -2845,7 +2903,7 @@ var PuppeteerBrowserContext = class extends EventEmitter5 {
       return false;
     }
     try {
-      const maxUpdateTime = getCurrentUnixTime4() - this.#maxPageFreeSeconds;
+      const maxUpdateTime = getCurrentUnixTime5() - this.#maxPageFreeSeconds;
       let freePages = this.#lsdPages.filter((p) => p.isFree() && p.pageInfo().lastStatusUpdateTime < maxUpdateTime);
       if (freePages.length === this.#lsdPages.length) {
         freePages = freePages.slice(1);
@@ -2861,6 +2919,9 @@ var PuppeteerBrowserContext = class extends EventEmitter5 {
       return false;
     }
   }
+  creationMethod() {
+    return this.#browserContextCreationMethod;
+  }
   doesMeetBrowserContextRequirements(browserContextRequirements) {
     if (!this.#lsdBrowser.doesMeetBrowserContextRequirements(browserContextRequirements)) {
       return false;
@@ -2979,17 +3040,30 @@ var PuppeteerBrowserContext = class extends EventEmitter5 {
       return false;
     }
   }
+  status() {
+    return this.#status;
+  }
+  use() {
+    if (this.#status === "free") {
+      this.#status = "busy";
+      this.#lastStatusUpdateTime = getCurrentUnixTime5();
+      return true;
+    } else {
+      return false;
+    }
+  }
   _origBrowserContext() {
     return this.#browserContext;
   }
 };
 
 // src/puppeteer/browser.ts
-import { getPerformanceOfPidTree as getPerformanceOfPidTree2, logerr as logerr7, loginfo as loginfo7, logwarn as logwarn5 } from "@letsscrapedata/utils";
+import { getCurrentUnixTime as getCurrentUnixTime6, getPerformanceOfPidTree as getPerformanceOfPidTree2, logerr as logerr7, loginfo as loginfo7, logwarn as logwarn5 } from "@letsscrapedata/utils";
 var PuppeteerBrowser = class extends EventEmitter6 {
   #browser;
   #browserIdx;
   #pid;
+  #createTime;
   #lsdBrowserContexts;
   #browserControllerType;
   #browserType;
@@ -3026,6 +3100,7 @@ var PuppeteerBrowser = class extends EventEmitter6 {
     this.#browser = browser;
     this.#browserIdx = browserIdx;
     this.#pid = pid;
+    this.#createTime = getCurrentUnixTime6();
     this.#lsdBrowserContexts = [];
     this.#browserControllerType = "puppeteer";
     this.#browserType = browerType;
@@ -3040,7 +3115,7 @@ var PuppeteerBrowser = class extends EventEmitter6 {
     const browserContexts = browser.browserContexts();
     const incognito = typeof options?.incognito === "boolean" ? options.incognito : false;
     for (const browserContext of browserContexts) {
-      const lsdBrowserContext = new PuppeteerBrowserContext(this, browserContext, incognito, this.#proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), this.#userAgent(), maxViewportOfNewPage);
+      const lsdBrowserContext = new PuppeteerBrowserContext(this, browserContext, "launch", incognito, this.#proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), this.#userAgent(), maxViewportOfNewPage);
       this.#lsdBrowserContexts.push(lsdBrowserContext);
       loginfo7(`##browser  ${lsdBrowserContext.id()} ${this.#browserCreationMethod}ed`);
     }
@@ -3092,7 +3167,7 @@ var PuppeteerBrowser = class extends EventEmitter6 {
     const browserContext = await this.#browser.createBrowserContext(browserContextOptions);
     const userAgent = options?.userAgent ? options.userAgent : "";
     const { maxViewportOfNewPage = this.#options.maxViewportOfNewPage } = options ? options : {};
-    const lsdBrowserContext = new PuppeteerBrowserContext(this, browserContext, true, proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), userAgent, maxViewportOfNewPage);
+    const lsdBrowserContext = new PuppeteerBrowserContext(this, browserContext, "new", true, proxy, this.#browserIdx, this.#nextBrowserContextIdx++, this.#maxPagesPerBrowserContext(), this.#maxPageFreeSeconds(), userAgent, maxViewportOfNewPage);
     this.#lsdBrowserContexts.push(lsdBrowserContext);
     loginfo7(`##browser  ${lsdBrowserContext.id()} created`);
     return lsdBrowserContext;
@@ -3121,6 +3196,9 @@ var PuppeteerBrowser = class extends EventEmitter6 {
   browserType() {
     return this.#browserType;
   }
+  createTime() {
+    return this.#createTime;
+  }
   doesMeetBrowserContextRequirements(browserContextRequirements) {
     const { browserControllerTypes, browserTypes, browserHeadlesses } = browserContextRequirements;
     return (browserControllerTypes.length === 0 || browserControllerTypes.includes(this.#browserControllerType)) && (browserTypes.length === 0 || browserTypes.includes(this.#browserType)) && (browserHeadlesses.length === 0 || browserHeadlesses.includes(this.#headless));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letsscrapedata/controller",
-  "version": "0.0.46",
+  "version": "0.0.47",
   "description": "Unified browser / HTML controller interfaces that support playwright, puppeteer and cheerio",
   "type": "module",
   "main": "./dist/index.cjs",