# Interacting with Browser Tasks

Once you've initiated a browser task in **Browser Swarm**, you can connect to it using your preferred automation framework to perform various actions such as navigation, form submissions, and data extraction.

***

### 🔗 Connecting to a Browser Task

After creating a browser task, you'll receive a `connectUrl` which is used to establish a connection with the browser instance. Here's how to connect using different frameworks:

#### 📘 Playwright

{% tabs %}
{% tab title="Node.js" %}

```javascript
import { chromium } from 'playwright-core';
import { createSession } from 'browser-swarm-sdk';

const session = await createSession({ browser: 'chromium' });
const browser = await chromium.connectOverCDP(session.connectUrl);
const page = await browser.newPage();

await page.goto('https://example.com');
```

{% endtab %}

{% tab title="Python" %}

```python
from playwright.sync_api import sync_playwright
from browser_swarm import create_session

session = create_session(browser='chromium')

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(session.connect_url)
    page = browser.new_page()
    page.goto('https://example.com')
```

{% endtab %}
{% endtabs %}

#### 🧪 Puppeteer

{% tabs %}
{% tab title="Node.js" %}

```javascript
import puppeteer from 'puppeteer-core';
import { createSession } from 'browser-swarm-sdk';

const session = await createSession({ browser: 'chromium' });
const browser = await puppeteer.connect({ browserWSEndpoint: session.connectUrl });
const page = await browser.newPage();

await page.goto('https://example.com');
```

{% endtab %}
{% endtabs %}

#### 🧪 Selenium

{% tabs %}
{% tab title="Python" %}

```python
from selenium import webdriver
from browser_swarm import create_session

session = create_session(browser='chrome')
options = webdriver.ChromeOptions()
options.add_experimental_option('debuggerAddress', session.connect_url)

driver = webdriver.Chrome(options=options)
d
```

{% endtab %}
{% endtabs %}

***

### Connection Best Practices

* **Timely Connection**: Connect to the browser task within 5 minutes of creation to prevent automatic termination.
* **Keep Alive**: For longer sessions, enable the `keepAlive` option during session creation.
* **Default Context**: Use the default browser context to ensure compatibility with features like stealth mode.

***

### Controlling the Browser

Once connected, you can control the browser using your framework's API. Common actions include:

* **Navigation**: `page.goto('https://example.com')`
* **Clicking Elements**: `page.click('#submit')`
* **Typing Text**: `page.type('#username', 'myUser')`
* **Extracting Content**: `page.content()`

***

###  Live View and Session Monitoring

**Browser Swarm** provides real-time monitoring tools:

* **Session Inspector**: View live browser interactions, network requests, console logs, and performance metrics. [->](https://browserswarm.gitbook.io/docs/broken-reference)
* **Embedded View**: Integrate a live browser view into your application for real-time observation and control. [->](https://browserswarm.gitbook.io/docs/broken-reference)

***

### Ending a Browser Task

To end a browser task:

* **Programmatically**: Use your framework's method, e.g., `browser.close()` or `session.close()`.
* **Automatically**: Tasks will terminate after a specified timeout or upon disconnection, unless `keepAlive` is enabled.

Properly ending tasks ensures resource optimization and prevents unnecessary charges.

***

For more advanced features like file [downloads](https://browserswarm.gitbook.io/docs/broken-reference), [stealth mode](https://browserswarm.gitbook.io/docs/broken-reference), and [proxy integration](https://browserswarm.gitbook.io/docs/broken-reference), refer to the respective sections in this documentation.