OpenAndSave

The following example demonstrates how to open a browser instance, save and restore a session, visit a webpage, perform actions (like login), and close the browser. The session is saved so that the next time the browser is opened, it restores the previous session without requiring you to log in again.

const svc = new BrowserService(token);

// FIRST VISIT --------------------------------------------------------------------
let browser = await openAndConnect(svc);
if (!browser) return;

let page = (await browser.pages())[0];

await page.goto("http://app.cloudbrowser.ai");
console.log("Web visited");

await login(page);
await new Promise((resolve) => setTimeout(resolve, 5000));

await browser.close();
console.log("Browser closed");

// SECOND VISIT -------------------------------------------------------------------
await new Promise((resolve) => setTimeout(resolve, 1000));

browser = await openAndConnect(svc);
if (!browser) return;

page = (await browser.pages())[0];

await page.goto("http://app.cloudbrowser.ai");
console.log("Web visited again");

// This time, logging in is not necessary.
await new Promise((resolve) => setTimeout(resolve, 5000));

await browser.close();
console.log("Browser closed");

// CHECK STORED SESSIONS ----------------------------------------------------------
const sessions = new SessionService(token);
console.log("Label | Created On | Last Update");
const sessionRp = await sessions.list();
for (const s of sessionRp.sessions ?? []) {
    console.log(`${s.label} | ${s.createdOn} | ${s.lastUpdate}`);
}

// REMOVE ONE SESSION
await sessions.remove("test");
}

async function openAndConnect(svc: BrowserService) {
const rp = await svc.open({
    label: "SessionSample",
    saveSession: true,
    recoverSession: true,
});

if (rp.status !== ResponseStatus.SUCCESS || rp.address == null) {
    console.log(`Error requesting browser: ${rp.status}`);
    return null;
}
console.log("Browser requested");

return await puppeteer.connect({
    browserWSEndpoint: rp.address,
    defaultViewport: null,
    slowMo: 0,
});
}

---

Full example

CloudBrowserAiNodeJS/samples/save-restore-session/src/index.ts at main · CloudBrowser-AI/CloudBrowserAiNodeJSGitHub

This code demonstrates the use of a browser service to manage session-based automation tasks with Puppeteer. It consists of three main parts:

1. First Visit

• A browser instance is created and connected using the openAndConnect function, which initializes a session with options to save and recover it later.

• A new page is opened, and the script navigates to http://app.cloudbrowser.ai. After the page loads, a login function is invoked to authenticate, followed by a 5-second delay.

• The browser is then closed, logging its closure.

2. Second Visit

• After a short delay (1 second), the browser session is reopened using openAndConnect.

• The same page (http://app.cloudbrowser.ai) is revisited, but logging in is skipped since the session recovery is enabled.

• A delay of 5 seconds is added before closing the browser again, and the closure is logged.

3. Session Management

• A SessionService instance is created to manage stored browser sessions.

• The script lists all active sessions, logging details like their labels, creation dates, and last update times.

• Finally, a session with the label "test" is explicitly removed.

Key Functionality

The openAndConnect function handles:

• Requesting a browser instance with session management options (saveSession and recoverSession).

• Handling connection errors, returning null if the browser cannot be opened.

• Establishing a Puppeteer connection using the provided WebSocket endpoint.

This setup enables efficient session handling and reusability, avoiding redundant login steps and providing visibility into session usage.