playwright-rs 0.12.0

Rust bindings for Microsoft Playwright
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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148

// Copyright 2026 Paul Adamson
// Licensed under the Apache License, Version 2.0

use crate::test_server::TestServer;
use std::sync::{Arc, Mutex};

use tokio::sync::Notify;

async fn notified_or_timeout(notify: &Notify, ms: u64, what: &str) {
    tokio::time::timeout(std::time::Duration::from_millis(ms), notify.notified())
        .await
        .unwrap_or_else(|_| panic!("timed out waiting for {what}"));
}

// ============================================================================
// Response server info: security_details, server_addr, finished
// ============================================================================

/// Verify security_details (None for HTTP), server_addr, and finished on a single response.
#[tokio::test]
async fn test_response_server_info() -> Result<(), Box<dyn std::error::Error>> {
    let server = TestServer::start().await;
    let (_pw, browser, page) = crate::common::setup().await;

    let response = page
        .goto(&server.url(), None)
        .await?
        .expect("goto should return a response");

    // security_details is None for HTTP
    let details = response.security_details().await?;
    assert!(
        details.is_none(),
        "security_details() should be None for HTTP"
    );

    // server_addr returns localhost
    let addr = response.server_addr().await?;
    assert!(addr.is_some(), "server_addr() should return Some for HTTP");
    let addr = addr.unwrap();
    assert_eq!(addr.ip_address, "127.0.0.1");
    assert!(addr.port > 0);

    // finished resolves for a completed response
    response.finished().await?;

    browser.close().await?;
    server.shutdown();
    Ok(())
}

// ============================================================================
// request.redirected_from / redirected_to
// ============================================================================

/// Verify redirect chain: request A redirects to request B.
/// B.redirected_from should be A, and A.redirected_to should be B.
#[tokio::test]
async fn test_request_redirect_chain() -> Result<(), Box<dyn std::error::Error>> {
    let server = TestServer::start().await;
    let (_pw, browser, page) = crate::common::setup().await;

    let redirect_url = format!("{}/redirect", server.url());
    let response = page
        .goto(&redirect_url, None)
        .await?
        .expect("goto should return a response");

    let final_request = response.request().expect("response should have a request");

    let redirected_from = final_request.redirected_from();
    assert!(
        redirected_from.is_some(),
        "Final request should have redirected_from"
    );

    let original_request = redirected_from.unwrap();
    assert!(
        original_request.url().contains("/redirect"),
        "Original request URL should contain /redirect, got: {}",
        original_request.url()
    );

    let redirected_to = original_request.redirected_to();
    assert!(
        redirected_to.is_some(),
        "Original request should have redirected_to"
    );

    browser.close().await?;
    server.shutdown();
    Ok(())
}

// ============================================================================
// request.response() and request.sizes()
// ============================================================================

/// Verify request.response() and request.sizes() on a finished request.
#[tokio::test]
async fn test_request_response_and_sizes() -> Result<(), Box<dyn std::error::Error>> {
    let server = TestServer::start().await;
    let (_pw, browser, page) = crate::common::setup().await;

    // Capture a finished navigation request
    let captured_request = Arc::new(Mutex::new(None));
    let req_clone = captured_request.clone();
    let notify = Arc::new(Notify::new());
    let notify2 = notify.clone();

    page.on_request_finished(move |request| {
        let capture = req_clone.clone();
        let n = notify2.clone();
        async move {
            if request.is_navigation_request() {
                *capture.lock().unwrap() = Some(request);
                n.notify_one();
            }
            Ok(())
        }
    })
    .await?;

    let _ = page.goto(&server.url(), None).await?;

    notified_or_timeout(&notify, 5000, "request_finished handler").await;

    let request = captured_request
        .lock()
        .unwrap()
        .take()
        .expect("Should have captured a finished navigation request");

    // request.response()
    let response = request.response().await?;
    assert!(response.is_some(), "request.response() should return Some");
    assert_eq!(response.unwrap().status(), 200);

    // request.sizes()
    let sizes = request.sizes().await?;
    assert!(sizes.response_body_size >= 0);
    assert!(sizes.response_headers_size >= 0);
    assert!(sizes.request_headers_size >= 0);

    browser.close().await?;
    server.shutdown();
    Ok(())
}