auditmysite 0.45.0

Resource-efficient WCAG 2.1 Accessibility Checker in Rust
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

//! Skip-link journey: activate a skip link and verify focus moves to target.

use chromiumoxide::Page;

use crate::audit::normalized::{InteractiveFinding, JourneyStep, JourneyTrace};
use crate::error::Result;
use crate::interaction::{focus, pointer, stability};
use crate::patterns::JourneyCandidate;
use crate::taxonomy::Severity;

pub async fn test(
    page: &Page,
    candidate: &JourneyCandidate,
    index: usize,
) -> Result<(JourneyTrace, Vec<InteractiveFinding>)> {
    let journey_name = format!("skip_link_{index}");
    let mut trace = JourneyTrace {
        journey: journey_name.clone(),
        steps: Vec::new(),
    };
    let mut findings: Vec<InteractiveFinding> = Vec::new();

    let trigger_id = match candidate.trigger_backend_id {
        Some(id) => id,
        None => return Ok((trace, findings)),
    };

    // Activate the skip link via synthetic click.
    if let Err(e) = pointer::synthetic_click_backend(page, trigger_id).await {
        tracing::warn!("skip_link: click on backend node {trigger_id} failed: {e}");
        return Ok((trace, findings));
    }
    trace.steps.push(JourneyStep {
        action: "synthetic_click".to_string(),
        target: Some(format!("backend_node:{trigger_id}")),
        focus: None,
        result: None,
        snapshot_label: Some("after_skip_click".to_string()),
    });

    stability::settle(page).await?;

    // Capture focus after activation.
    let snap = focus::capture_focus(page).await?;
    let focus_selector = snap.selector.clone();

    // Determine if focus actually moved to a meaningful target.
    let focus_on_body = focus_selector.is_none()
        || focus_selector
            .as_deref()
            .map(|s| {
                let low = s.to_lowercase();
                low == "body" || low == "html"
            })
            .unwrap_or(false);

    trace.steps.push(JourneyStep {
        action: "check_focus".to_string(),
        target: None,
        focus: focus_selector.clone(),
        result: Some(if focus_on_body {
            "focus_not_moved".to_string()
        } else {
            "focus_moved".to_string()
        }),
        snapshot_label: Some("after_skip_link".to_string()),
    });

    if focus_on_body {
        findings.push(InteractiveFinding {
            category: "SkipLink".to_string(),
            maps_to_finding: None,
            severity: Severity::High,
            journey: journey_name,
            before_snapshot_label: None,
            after_snapshot_label: Some("after_skip_link".to_string()),
            message: "Skip link is present but does not move focus to the target. \
                Keyboard users cannot bypass navigation."
                .to_string(),
            fix_suggestion: Some(
                "Ensure the skip link target has tabindex=\"-1\" and receives focus via \
                an anchor link, or explicitly call target.focus() after navigation."
                    .to_string(),
            ),
        });
    }

    Ok((trace, findings))
}