codetether-browser 0.1.0

Browser automation runtime for CodeTether
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

//! Form-oriented DOM operations.

use crate::browser::{
    BrowserError, BrowserOutput,
    request::{ClickTextRequest, FillRequest, ToggleRequest},
};
use tetherscript::browser_agent::Locator;

/// Fill an input-like element by selector.
///
/// # Errors
///
/// Returns [`BrowserError`] when the session is not started, the selector does
/// not resolve, or the element cannot be filled.
pub(in crate::browser::session::native) async fn fill(
    session: &super::super::super::BrowserSession,
    request: FillRequest,
) -> Result<BrowserOutput, BrowserError> {
    super::page::with(session, |page| {
        page.fill(&super::selector::css(request.selector), &request.value)
            .map(|_| ())
    })
    .await
}

/// Click an element matched by visible text.
///
/// # Errors
///
/// Returns [`BrowserError`] when the session is not started or no matching
/// element can be clicked.
pub(in crate::browser::session::native) async fn click_text(
    session: &super::super::super::BrowserSession,
    request: ClickTextRequest,
) -> Result<BrowserOutput, BrowserError> {
    let locator = if request.exact {
        Locator::text_exact(request.text).relaxed()
    } else {
        Locator::text(request.text).relaxed()
    };
    super::page::with(session, |page| page.click(&locator).map(|_| ())).await
}

/// Toggle a checkbox-like control by selector.
///
/// # Errors
///
/// Returns [`BrowserError`] when the session is not started or script
/// evaluation fails.
pub(in crate::browser::session::native) async fn toggle(
    session: &super::super::super::BrowserSession,
    request: ToggleRequest,
) -> Result<BrowserOutput, BrowserError> {
    let script = format!(
        "let el=document.querySelector({});el.checked=!el.checked;el.dispatchEvent({{type:'change'}});",
        super::selector::quote(&request.selector)
    );
    super::page::with(session, |page| page.eval_js(&script).map(|_| ())).await
}