ferridriver 0.4.0

Browser automation in Rust with a Playwright-compatible API. Four pluggable backends: CDP pipe, CDP WebSocket, Playwright WebKit, Firefox BiDi.
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

//! End-to-end smoke test for the Playwright `WebKit` backend.
//!
//! Skipped unless a Playwright `WebKit` binary is reachable via
//! `FERRIDRIVER_WEBKIT` or the standard Playwright cache. Exercises
//! launch -> context -> page -> navigate -> evaluate -> close through
//! the high-level `WebKitBrowser` / `AnyPage` surface.

use ferridriver::backend::NavLifecycle;
use ferridriver::backend::webkit::{LaunchConfig, WebKitBrowser, locate_binary};

fn binary_available() -> bool {
  locate_binary().is_ok()
}

#[tokio::test]
async fn webkit_launch_navigate_evaluate() {
  let _ = tracing_subscriber::fmt()
    .with_env_filter(
      tracing_subscriber::EnvFilter::try_from_default_env().unwrap_or_else(|_| "ferridriver=info".into()),
    )
    .with_writer(std::io::stderr)
    .try_init();

  if !binary_available() {
    eprintln!("skipping: no Playwright WebKit binary found (set FERRIDRIVER_WEBKIT)");
    return;
  }

  let config = LaunchConfig {
    headless: true,
    ..LaunchConfig::default()
  };
  let mut browser = match WebKitBrowser::launch(&config).await {
    Ok(b) => b,
    Err(e) => {
      eprintln!("skipping: launch failed ({e}); is libicu74 missing? install AUR `icu74` on Arch");
      return;
    },
  };
  eprintln!("PW WebKit version: {}", browser.version());

  let context_id = browser.new_context(None).await.expect("new_context");
  let page = browser
    .new_page("data:text/html,<h1>hello</h1>", Some(&context_id), None)
    .await
    .expect("new_page");

  let _ = page
    .goto("data:text/html,<h1>hello</h1>", NavLifecycle::Load, 30_000, None)
    .await;

  let value = page.evaluate("1 + 1").await.expect("evaluate");
  assert_eq!(value, Some(serde_json::json!(2)), "evaluate returned: {value:?}");

  let html = page
    .evaluate("document.documentElement.outerHTML")
    .await
    .expect("evaluate outerHTML");
  assert!(
    html
      .as_ref()
      .and_then(|v| v.as_str())
      .is_some_and(|s| s.contains("hello")),
    "outerHTML should include the navigated content: {html:?}"
  );

  page
    .close_page(ferridriver::options::PageCloseOptions::default())
    .await
    .expect("close page");
  browser.close().await.expect("close browser");
}