Function emulate

src/commands/emulation.rs:66–251

Execute the unified emulation command.

(
    client: &mut CdpClient,
    session_id: &str,
    params: EmulateParams,
)

/// Execute the unified emulation command.
pub async fn emulate(
    client: &mut CdpClient,
    session_id: &str,
    params: EmulateParams,
) -> Result<CommandResult> {
    let mut actions = Vec::new();

    // 0. Handle network blocklist (applied to the persistent session, not the
    //    per-command session — so the blocklist survives across commands/targets).
    let network_changed = !params.block_url.is_empty()
        || !params.unblock_url.is_empty()
        || params.clear_blocks
        || params.clear_all;

    if params.clear_all || params.clear_blocks {
        client.blocklist.clear();
        actions.push("Network blocks cleared".to_string());
    }

    for pattern in &params.block_url {
        if !client.blocklist.contains(pattern) {
            client.blocklist.push(pattern.clone());
        }
    }
    if !params.block_url.is_empty() {
        actions.push(format!("Blocked URLs: {}", params.block_url.join(", ")));
    }

    for pattern in &params.unblock_url {
        client.blocklist.retain(|p| p != pattern);
    }
    if !params.unblock_url.is_empty() {
        actions.push(format!(
            "Un-blocked URLs: {}",
            params.unblock_url.join(", ")
        ));
    }

    if network_changed {
        // Apply to persistent session if available; otherwise fall back to the
        // command's session (e.g., direct mode or degraded daemon path).
        if client.persistent_session.is_some() {
            client.apply_network_rules().await?;
        } else {
            client.apply_network_rules_internal(session_id).await?;
        }
    }

    // 1. Handle clearing
    if params.clear_all || params.clear_viewport {
        client
            .send_to_target(
                session_id,
                "Emulation.clearDeviceMetricsOverride",
                json!({}),
            )
            .await?;
        client.viewport = None;