Playwright

We support playwright for Javascript out of the box for all their supported browsers.

Using the Playwright Protocol​

The standard connect method uses Playwright's built-in browser-server protocol to handle the connection. This, generally, is a faster and more fully-featured method since it supports most of the Playwright parameters (such as using a proxy and more). However, since this requires the usage of Playwright in our servers, your client's Playwright version should match ours.

Take a screenshot in Playwright with Firefox​

import playwright from "playwright-core";

const pwEndpoint = `wss://production-sfo.browserless.io/firefox/playwright?token=YOUR_API_TOKEN_HERE`;
const browser = await playwright.firefox.connect(pwEndpoint);
const context = await browser.newContext();
const page = await context.newPage();

await page.goto("https://www.nexcess.net/web-tools/browser-information/");
await new Promise((resolve) => setTimeout(resolve, 50000));
await page.screenshot({
  path: `firefox.png`,
});

await browser.close();

Similarly, if you need to use another browser, just make sure the Playwright Browser object matches the endpoint.

Using the Chrome DevTools Protocol​

The connectOverCDP method allows Playwright to connect through Chrome's DevTools Protocol. While this is more functionally similar to how puppeteer operates, it does come with a slight performance hit since sessions are more "chatty" over the network versus Playwright's connect. Furthermore, you can only use the Chrome for these connections.

Take a screenshot in Playwright​

import playwright from "playwright";

const browser = await playwright.chromium.connectOverCDP(
  "wss://production-sfo.browserless.io?token=YOUR_API_TOKEN_HERE"
);
const context = await browser.newContext();
const page = await context.newPage();

await page.goto("https://www.example.com/");
await page.screenshot({ path: "cdp.png" });

await browser.close();

We support Playwright for Python out of the box via their playwright.browser.connect() method.

Here's a simple snippet of its implementation, we can add additional features through the context, such as a proxy if necessary.

Print page content​

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
  browser = p.firefox.connect('wss://production-sfo.browserless.io/firefox/playwright?token=YOUR_API_TOKEN_HERE')
  context = browser.new_context()
  page = context.new_page()
  page.goto('http://www.example.com', wait_until='domcontentloaded')
  print(page.content())
  context.close()

We support playwright for Java out of the box, and just as with JavaScript, we can use either connect() or connectOverCDP().

Here's a simple snippet of its implementation.

Scrape a site title with playwright​

package org.example;

import com.microsoft.playwright.Browser;
import com.microsoft.playwright.Page;
import com.microsoft.playwright.Playwright;

import java.nio.file.Paths;

public class Main {
  public static void main(String[] args) {
    try (Playwright playwright = Playwright.create()) {
      String wsEndpoint = "ws://production-sfo.browserless.io/webkit/playwright?token=YOUR_API_TOKEN_HERE";
      Browser browser = playwright.webkit().connect(wsEndpoint);

      Page page = browser.newPage();
      page.navigate("https://www.whatismybrowser.com/");
      page.screenshot(new Page.ScreenshotOptions().setPath(Paths.get("webkit.png")));

      browser.close();
    } catch (Exception exception) {
      exception.printStackTrace();
    }
  }
}

We support playwright for C# out of the box, and just as with JavaScript, we can use either connect() or connectOverCDP().

Take a screenshot in playwright​

using Microsoft.Playwright;
using System.Threading.Tasks;
using System;

class Program
{
    public static async Task Main()
    {
        try{
          using var playwright = await Playwright.CreateAsync();
          await using var browser = await playwright.Chromium.ConnectOverCDPAsync("wss://production-sfo.browserless.io?token=YOUR_API_TOKEN_HERE");
          var page = await browser.NewPageAsync();
          await page.GotoAsync("https://example.com/", new PageGotoOptions { WaitUntil = WaitUntilState.NetworkIdle });
          await page.ScreenshotAsync(new PageScreenshotOptions { Path = "example.png" });
        }
        catch (Exception e){
        Debug.WriteLine(e.ToString());
      }
    }
}