oxibrowser-cdp 0.2.0

Chrome DevTools Protocol server for browser automation
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

//! CDP Fetch domain handler.
//!
//! Handles network interception via Fetch.enable, Fetch.disable,
//! Fetch.continueRequest, Fetch.failRequest, Fetch.fulfillRequest.
//!
//! When enabled, outgoing HTTP requests are paused and a
//! `Fetch.requestPaused` event is sent to the client.
//! The client responds with continue/fail/fulfill.
//!
//! Note: Interception is currently notification-only (emit events).
//! Full request pausing (blocking the HTTP request until the client
//! responds) requires deeper integration with the HTTP client pipeline.

use crate::domains::{DispatchContext, DomainResult};
use crate::protocol::CdpError;
use serde_json::{json, Value};

/// Dispatch Fetch domain methods.
pub async fn handle(method: &str, params: Option<Value>, ctx: &DispatchContext) -> DomainResult {
    match method {
        "enable" => enable(params, ctx),
        "disable" => disable(ctx),
        "continueRequest" => Ok(Some(json!({}))),
        "failRequest" => Ok(Some(json!({}))),
        "fulfillRequest" => Ok(Some(json!({}))),
        "continueResponse" => Ok(Some(json!({}))),
        _ => Err(CdpError {
            code: -32601,
            message: format!("Fetch.{} not implemented", method),
        }),
    }
}

/// Fetch.enable — enables request interception.
///
/// Accepts optional `patterns` array and `handleAuthRequests` flag.
fn enable(_params: Option<Value>, ctx: &DispatchContext) -> DomainResult {
    // TODO: Parse patterns and store them for request matching.
    // Currently, interception is notification-only.
    ctx.events.set_fetch_enabled(true);
    tracing::info!("Fetch domain enabled");
    Ok(Some(json!({})))
}

/// Fetch.disable — disables request interception.
fn disable(ctx: &DispatchContext) -> DomainResult {
    ctx.events.set_fetch_enabled(false);
    tracing::info!("Fetch domain disabled");
    Ok(Some(json!({})))
}

/// Emit a `Fetch.requestPaused` event for an intercepted request.
///
/// Called from the navigation pipeline when Fetch domain is enabled.
pub fn emit_request_paused(
    events: &crate::event::EventSender,
    request_id: &str,
    url: &str,
    resource_type: &str,
) {
    events.send_fetch_event(
        "Fetch.requestPaused",
        serde_json::json!({
            "requestId": request_id,
            "request": {
                "url": url,
                "method": "GET",
                "headers": {},
                "initialPriority": "VeryHigh",
                "urlFragment": "",
            },
            "resourceType": resource_type,
            "frameId": "main",
            "networkIntercepted": true,
        }),
    );
}