thirtyfour 0.37.0

Thirtyfour is a Selenium / WebDriver library for Rust, for automated website UI testing. Tested on Chrome and Firefox, but any webdriver-capable browser should work.
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

//! Newtypes for opaque CDP identifiers.
//!
//! CDP uses a number of string and integer ids that are easy to mix up at
//! the call site (`FrameId` vs `TargetId`, `NodeId` vs `BackendNodeId`,
//! …). These newtypes preserve the wire format while staying distinct
//! in Rust.

use crate::common::protocol::{int_id, string_id};

string_id! {
    /// Identifier for a frame in the page's frame tree (`Page.FrameId`).
    FrameId
}

string_id! {
    /// Identifier for an in-flight network request (`Network.RequestId`).
    /// One id covers redirects under the same logical request.
    RequestId
}

string_id! {
    /// Identifier for an in-flight resource fetch interception
    /// (`Network.InterceptionId`).
    InterceptionId
}

string_id! {
    /// Identifier for an in-flight `Fetch` interception (`Fetch.RequestId`).
    FetchRequestId
}

string_id! {
    /// Identifier for a remote V8 object (`Runtime.RemoteObjectId`). Held
    /// alive by V8 in a specific execution context.
    RemoteObjectId
}

string_id! {
    /// Identifier for a CDP target (`Target.TargetId`). Stable across
    /// attach/detach.
    TargetId
}

string_id! {
    /// Routing key on a single CDP WebSocket in flat session mode
    /// (`Target.SessionId`).
    SessionId
}

string_id! {
    /// Identifier for an isolation container (`Browser.BrowserContextId`).
    BrowserContextId
}

string_id! {
    /// Identifier for a loader inside the page (`Network.LoaderId`).
    LoaderId
}

string_id! {
    /// Identifier for a Runtime script (`Runtime.ScriptId`). The name
    /// looks numeric but CDP defines it as an opaque string.
    ScriptId
}

int_id! {
    /// Short-lived integer id of a DOM node (`DOM.NodeId`). Valid only while
    /// the DOM agent is enabled in this session.
    NodeId(i64)
}

int_id! {
    /// Stable integer id for a DOM node (`DOM.BackendNodeId`). Survives DOM
    /// agent reattachment and crosses sessions.
    BackendNodeId(i64)
}

int_id! {
    /// Identifier for a Runtime execution context
    /// (`Runtime.ExecutionContextId`).
    ExecutionContextId(i64)
}

int_id! {
    /// Time origin for `Runtime.Timestamp` and `Network.MonotonicTime` —
    /// milliseconds since CDP's monotonic time origin, as `f64`.
    /// Stored unmodified; convert to `Duration` at the call site if needed.
    Timestamp(i64)
}

// Wire-shape coverage for these ids lives in the integration tests in
// `thirtyfour/tests/cdp_typed.rs` — every command that returns or accepts
// an id round-trips through real chromedriver.