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
60
61
62
63
64

//! Page navigation operations for native sessions.

use crate::browser::{BrowserError, BrowserOutput, request::NavigationRequest};

/// Navigate the current tab to a URL.
///
/// # Errors
///
/// Returns [`BrowserError`] when the page cannot be loaded or the session is
/// not started.
pub(super) async fn goto(
    session: &super::super::BrowserSession,
    request: NavigationRequest,
) -> Result<BrowserOutput, BrowserError> {
    let html = super::fetch::html(&request.url).await?;
    let mut native = session.inner.native.lock().await;
    let slot = native
        .as_mut()
        .ok_or(BrowserError::SessionNotStarted)?
        .current_mut()?;
    let mut page = slot.page();
    page.goto_html(request.url, html);
    let _ = page.run_scripts();
    slot.replace(page);
    Ok(super::lifecycle::ack())
}

/// Navigate backward in the current tab history.
///
/// # Errors
///
/// Returns [`BrowserError`] when the session is not started.
pub(super) async fn back(
    session: &super::super::BrowserSession,
) -> Result<BrowserOutput, BrowserError> {
    let mut native = session.inner.native.lock().await;
    native
        .as_mut()
        .ok_or(BrowserError::SessionNotStarted)?
        .current_mut()?
        .session
        .back();
    Ok(super::lifecycle::ack())
}

/// Reload the current tab.
///
/// # Errors
///
/// Returns [`BrowserError`] when the session is not started.
pub(super) async fn reload(
    session: &super::super::BrowserSession,
) -> Result<BrowserOutput, BrowserError> {
    let mut native = session.inner.native.lock().await;
    let slot = native
        .as_mut()
        .ok_or(BrowserError::SessionNotStarted)?
        .current_mut()?;
    let mut page = slot.page();
    page.reload();
    let _ = page.run_scripts();
    slot.replace(page);
    Ok(super::lifecycle::ack())
}