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.

static async Task Main(string[] args) {
    const string token = "YOUR CLOUDBROWSER.AI TOKEN";
    using BrowserService svc = new(token);

    // FIRST VISIT --------------------------------------------------------------------
    var browser = await OpenAndConnect(svc).ConfigureAwait(false);
    if (browser == null)
        return;

    var page = (await browser.PagesAsync().ConfigureAwait(false))[0];

    await page.GoToAsync("http://app.cloudbrowser.ai").ConfigureAwait(false);
    Console.WriteLine("Web visited");

    await Login(page).ConfigureAwait(false);
    await Task.Delay(5000).ConfigureAwait(false);

    await browser.CloseAsync().ConfigureAwait(false);
    Console.WriteLine("Browser closed");

    // SECOND VISIT -------------------------------------------------------------------
    await Task.Delay(1000).ConfigureAwait(false);

    browser = await OpenAndConnect(svc).ConfigureAwait(false);
    if (browser == null)
        return;

    page = (await browser.PagesAsync().ConfigureAwait(false))[0];

    await page.GoToAsync("http://app.cloudbrowser.ai").ConfigureAwait(false);
    Console.WriteLine("Web visited again");

    // This time, logging in is not necessary.
    await Task.Delay(5000).ConfigureAwait(false);

    await browser.CloseAsync().ConfigureAwait(false);
    Console.WriteLine("Browser closed");

    // CHECK STORED SESSIONS ----------------------------------------------------------
    using SessionService sessions = new(token);
    Console.WriteLine("Label | Created On | Last Update");
    var sessionRp = await sessions.List().ConfigureAwait(false);
    foreach(var s in sessionRp.Sessions) {
        Console.WriteLine("{0} | {1} | {2}",s.Label,s.CreatedOn, s.LastUpdate);
    }

    // REMOVE ONE SESSION
    await sessions.Remove("test").ConfigureAwait(false);
}

static async Task<IBrowser?> OpenAndConnect(BrowserService svc) {
    var rp = await svc.Open(new() {
        Label = "SessionSample",      // Label for the session
        SaveSession = true,           // Save session after browser closes
        RecoverSession = true        // Recover saved session on next browser launch
    }).ConfigureAwait(false);

    if (rp.Status == ResponseStatus.Succes) {
        Console.WriteLine("Browser requested");
    } else {
        Console.WriteLine("Error requesting browser: {0}", rp.Status.ToString());
        return null;
    }

    return await Puppeteer.ConnectAsync(new ConnectOptions {
        BrowserWSEndpoint = rp.Address,
        DefaultViewport = null,
        AcceptInsecureCerts = true,
        SlowMo = 0
    }).ConfigureAwait(continueOnCapturedContext: false);
}

static async Task Login(IPage page) {
    // Simulating login by filling out email and password fields and submitting the form
    await page.TypeAsync("[type=\"email\"]", "email").ConfigureAwait(false);
    await page.TypeAsync("[type=\"password\"]", "password").ConfigureAwait(false);
    await page.ClickAsync("[type=\"submit\"]").ConfigureAwait(false);
}

---

Full example

CloudBrowserAiSharp/samples/OpenAndSave.cs/Program.cs at main · CloudBrowser-AI/CloudBrowserAiSharpGitHub

How It Works

1. Initialize the Client: Create an instance of BrowserService using your API token.

2. Request a Browser Instance with Session Saving and Recovery: Call svc.Open() with the following options:

   • Label: Set a custom label for the browser session.

   • SaveSession: Enable session saving, so that the state of the session (like cookies and local storage) is stored.

   • RecoverSession: Enable session recovery, so the session is restored the next time the browser is opened.

3. Perform Actions: Navigate to a webpage (in this case, http://app.cloudbrowser.ai), simulate a login, and close the browser.

4. Session Restore: On the second visit, the session is automatically restored, so you don’t need to log in again.

5. Manage Stored Sessions: Use the SessionService to list all stored sessions, remove a session, or interact with them as needed.

6. Close the Browser: The browser can be closed after each interaction using browser.CloseAsync(). The session data is saved for the next time you open the browser with session recovery enabled.

---

This approach enables you to save and restore sessions across multiple visits to the same page, making it more efficient for use cases like logging in once and maintaining the session for subsequent visits.