tauri-plugin-hasgard 0.3.0

Native automation and testing bridge for Tauri 2 applications
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

use std::path::Path;

use super::ScreenshotError;

/// Capture a window's pixels by shelling out to the `screencapture` system tool.
///
/// Invokes `screencapture -x -l <window_id> <path>` so the call is silent and
/// targets one window rather than the whole screen. Requires Screen Recording
/// permission in System Settings -> Privacy & Security; the first invocation
/// under a sandboxed host surfaces the macOS permission dialog.
///
/// # Errors
///
/// Returns [`ScreenshotError::CaptureFailed`] when the child process cannot be
/// spawned or exits with a non-zero status (TCC-denied, unknown window id, or
/// unwritable output path).
pub(crate) fn capture_screencapture(window_id: u32, path: &Path) -> Result<(), ScreenshotError> {
    use std::process::Command;

    let status = Command::new("screencapture")
        .arg("-x")
        .arg("-l")
        .arg(window_id.to_string())
        .arg(path)
        .status()
        .map_err(|err| ScreenshotError::CaptureFailed { message: format!("spawn screencapture: {err}") })?;
    if !status.success() {
        return Err(ScreenshotError::CaptureFailed { message: format!("screencapture exited with {status}") });
    }
    Ok(())
}