playwright-cdp 0.2.0

Drive Chromium directly via the Chrome DevTools Protocol (CDP) — no Playwright driver required.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

//! Browser-context isolation + cookies + storage_state round-trip.
//!
//! Two contexts share the same browser but have isolated storage. We set a
//! cookie and a localStorage entry in context #1, snapshot its storage state,
//! restore it into context #2, and confirm both the cookie and the localStorage
//! value survive the round-trip.
//!
//! Run: `cargo run --example contexts`

use playwright_cdp::options::LaunchOptions;
use playwright_cdp::types::Cookie;
use playwright_cdp::Playwright;

/// A minimal loop-accepting HTTP server serving a fixed HTML page so we have a
/// real, stable origin for cookies and localStorage. Returns the base URL.
async fn serve() -> String {
    let l = tokio::net::TcpListener::bind("127.0.0.1:0").await.unwrap();
    let port = l.local_addr().unwrap().port();
    tokio::spawn(async move {
        loop {
            let Ok((mut s, _)) = l.accept().await else { break };
            tokio::spawn(async move {
                use tokio::io::{AsyncReadExt, AsyncWriteExt};
                let mut buf = [0u8; 4096];
                let _ = s.read(&mut buf).await;
                let body = "<!doctype html><html><body><h1>contexts demo</h1></body></html>";
                let resp = format!(
                    "HTTP/1.1 200 OK\r\nContent-Type: text/html\r\nContent-Length: {}\r\nConnection: close\r\n\r\n{body}",
                    body.len()
                );
                let _ = s.write_all(resp.as_bytes()).await;
                let _ = s.flush().await;
            });
        }
    });
    format!("http://127.0.0.1:{port}/")
}

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let _ = tracing_subscriber::fmt()
        .with_env_filter(
            tracing_subscriber::EnvFilter::try_from_default_env()
                .unwrap_or_else(|_| "playwright_cdp=info".into()),
        )
        .try_init();

    let browser = Playwright::launch()
        .await?
        .chromium()
        .launch_with_options(LaunchOptions::default())
        .await?;
    println!("browser version: {}", browser.version().await?);

    let url = serve().await;
    println!("serving contexts demo page at {url}");

    // --- context #1: set a cookie + localStorage, then snapshot ---
    let ctx1 = browser.new_context().await?;
    let p1 = ctx1.new_page().await?;
    p1.goto(&url, None).await?;

    // `Cookie` does not derive Default, so construct it explicitly with the
    // fields we care about and `None` for the rest.
    ctx1.add_cookies(&[Cookie {
        name: "session".into(),
        value: "abc".into(),
        url: Some(url.clone()),
        domain: None,
        path: None,
        expires: None,
        http_only: None,
        secure: None,
        same_site: None,
    }])
    .await?;
    println!("added cookie session=abc to context #1");

    // Reload so the new cookie is present in document.cookie.
    p1.reload(None).await?;
    let doc_cookie: String = p1.evaluate("document.cookie").await?;
    println!("document.cookie after reload: {doc_cookie}");
    assert!(doc_cookie.contains("session=abc"));

    p1.evaluate::<()>("localStorage.setItem('k','v')").await?;
    println!("set localStorage k=v in context #1");

    let state = ctx1.storage_state().await?;
    println!(
        "\nsnapshot: cookies={}  origins={}",
        state.cookies.len(),
        state.origins.len()
    );
    for o in &state.origins {
        let names: Vec<&str> = o.localStorage.iter().map(|nv| nv.name.as_str()).collect();
        println!("  origin {} localStorage keys: {:?}", o.origin, names);
    }
    assert!(
        state.cookies.iter().any(|c| {
            c.get("name").and_then(|v| v.as_str()) == Some("session")
                && c.get("value").and_then(|v| v.as_str()) == Some("abc")
        }),
        "snapshot should contain the session cookie"
    );

    // --- context #2: restore the snapshot, confirm cookie + localStorage ---
    let ctx2 = browser.new_context().await?;
    ctx2.set_storage_state(&state).await?;
    let p2 = ctx2.new_page().await?;
    p2.goto(&url, None).await?;

    let ls: String = p2.evaluate("localStorage.getItem('k')").await?;
    println!("\ncontext #2 localStorage.getItem('k'): {ls:?}");
    assert_eq!(ls, "v");

    let doc_cookie2: String = p2.evaluate("document.cookie").await?;
    println!("context #2 document.cookie: {doc_cookie2}");
    assert!(
        doc_cookie2.contains("session=abc"),
        "restored cookie should be visible in context #2"
    );

    println!("\ncontext isolation + storage_state round-trip verified.");
    browser.close().await?;
    println!("done.");
    Ok(())
}