captchaforge 0.2.36

[DO NOT USE — UNDER ACTIVE DEVELOPMENT, NOT PRODUCTION-READY] Captcha solver scaffolding for chromiumoxide-driven browsers. The architecture is in place (vendor solvers, retry-loop iframe walking, VLM provider abstraction, real-WAF bench harness) but the live-vendor success rate is still 0% — Cloudflare Turnstile / hCaptcha / reCAPTCHA detect us at a TLS / CDP fingerprint layer that no flag-based stealth has cleared. Watch the repo; do not depend on this for any real workload.
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
94
95
96
97
98
99
100
101

//! Integration tests for error handling and edge cases.

use captchaforge::detect::{detect, is_captcha, CaptchaInfo};
use captchaforge::solver::CaptchaSolverChain;

mod common;

#[tokio::test]
async fn detect_on_data_url() {
    let mut browser = common::launch_browser().await;
    let page = browser
        .new_page("data:text/html,<h1>Hello</h1>")
        .await
        .unwrap();
    let result = detect(&page).await.unwrap();
    assert!(!is_captcha(&result));
    browser.close().await.unwrap();
}

#[tokio::test]
async fn chain_solve_on_plain_page_returns_unsolved() {
    let mut browser = common::launch_browser().await;
    let page = browser.new_page("about:blank").await.unwrap();
    let chain = CaptchaSolverChain::default_chain();
    let info = CaptchaInfo {
        kind: captchaforge::detect::DetectedCaptcha::None,
        site_key: None,
        page_url: page.url().await.unwrap().unwrap_or_default(),
        container_selector: None,
    };
    let result = chain.solve(&page, &info).await;
    assert!(!result.success);
    browser.close().await.unwrap();
}

#[tokio::test]
async fn navigate_to_invalid_url_graceful() {
    let mut browser = common::launch_browser().await;
    let result = browser.new_page("not-a-valid-url").await;
    // Chromiumoxide may either succeed (and load an error page) or fail.
    // Either is acceptable; we just verify it doesn't panic.
    if let Ok(page) = result {
        let _ = detect(&page).await;
    }
    browser.close().await.unwrap();
}

#[tokio::test]
async fn evaluate_malformed_js_returns_error() {
    let mut browser = common::launch_browser().await;
    let page = browser.new_page("about:blank").await.unwrap();
    let result = page.evaluate("function() { return 1").await;
    assert!(result.is_err());
    browser.close().await.unwrap();
}

#[tokio::test]
async fn evaluate_undefined_is_ok() {
    let mut browser = common::launch_browser().await;
    let page = browser.new_page("about:blank").await.unwrap();
    let result = page.evaluate("undefined").await;
    assert!(result.is_ok());
    browser.close().await.unwrap();
}

#[tokio::test]
async fn evaluate_null_is_ok() {
    let mut browser = common::launch_browser().await;
    let page = browser.new_page("about:blank").await.unwrap();
    let result = page.evaluate("null").await;
    assert!(result.is_ok());
    browser.close().await.unwrap();
}

#[tokio::test]
async fn page_reload_preserves_title() {
    let mut browser = common::launch_browser().await;
    let addr = common::serve_once(
        r#"<!DOCTYPE html><html><head><title>Persist</title></head><body></body></html>"#.into(),
    )
    .await;
    let page = browser.new_page(format!("http://{}", addr)).await.unwrap();
    tokio::time::sleep(std::time::Duration::from_millis(200)).await;
    let title: String = page
        .evaluate("document.title")
        .await
        .unwrap()
        .into_value()
        .unwrap();
    assert_eq!(title, "Persist");
    page.reload().await.unwrap();
    tokio::time::sleep(std::time::Duration::from_millis(200)).await;
    let title_after: String = page
        .evaluate("document.title")
        .await
        .unwrap()
        .into_value()
        .unwrap();
    assert_eq!(title_after, "Persist");
    browser.close().await.unwrap();
}