zendriver 0.2.0

Async-first, undetectable browser automation via the Chrome DevTools Protocol
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

//! Shared JS-evaluation surface across types that own a CDP session/contextId.

use serde::de::DeserializeOwned;

use crate::error::Result;

/// Types that can evaluate JavaScript in their context.
///
/// Implemented by [`crate::Tab`] (main frame) and [`crate::Frame`]
/// (per-frame contextId). [`crate::Element`] evaluation has a different
/// shape (binds `el` parameter) and has its own
/// [`crate::Element::evaluate`] / [`crate::Element::evaluate_main`]
/// inherent methods — Element does NOT implement this trait.
///
/// # Examples
///
/// ```no_run
/// use zendriver::Evaluable;
/// async fn get_title<E: Evaluable + Sync>(e: &E) -> zendriver::Result<String> {
///     e.evaluate_main("document.title").await
/// }
/// ```
#[async_trait::async_trait]
pub trait Evaluable {
    /// Evaluate JS in an isolated world (sandbox; no page globals visible).
    ///
    /// Default for stealth-safe execution.
    async fn evaluate<T>(&self, js: &str) -> Result<T>
    where
        T: DeserializeOwned + Send + 'static;

    /// Evaluate JS in the main world (page globals accessible).
    async fn evaluate_main<T>(&self, js: &str) -> Result<T>
    where
        T: DeserializeOwned + Send + 'static;
}