ferridriver-cli 0.4.0

//! §2.9 Rule-9 integration tests: Dialog as a first-class event
//! handle accessible from scripts via `page.waitForEvent('dialog')`.
//!
//! The QuickJS binding returns a live [`ferridriver::dialog::Dialog`]
//! wrapper that exposes `type()` / `message()` / `defaultValue()` /
//! `accept(promptText?)` / `dismiss()`. These tests dispatch a
//! navigation that triggers `alert` / `confirm` / `prompt` and
//! observe both the read-only accessors and the side effects of
//! accept / dismiss on the page.
//!
//! Backend coverage:
//! * cdp-pipe / cdp-raw — full round-trip through
//!   `Page.javascriptDialogOpening` + `Page.handleJavaScriptDialog`.
//! * bidi — full round-trip through
//!   `browsingContext.userPromptOpened` + `browsingContext.handleUserPrompt`.
//! * webkit — the Obj-C host's `WKUIDelegate` decides the accept /
//!   dismiss before the event reaches Rust; the Dialog handle is
//!   still emitted so listeners can observe `type` / `message`, but
//!   calling `accept` / `dismiss` on the handle returns the typed
//!   error documented in `backend/webkit/mod.rs`. That branch is
//!   asserted explicitly rather than silently skipped.

#![allow(
  clippy::too_many_lines,
  clippy::doc_markdown,
  clippy::uninlined_format_args,
  clippy::unwrap_used,
  clippy::expect_used,
  clippy::needless_pass_by_value
)]

use super::client::McpClient;

/// `page.waitForEvent('dialog')` + `dialog.accept()` lets the page's
/// `confirm()` return `true`, which the test observes via
/// `document.title`.
pub fn test_dialog_accept_confirm(c: &mut McpClient) {
  // The page schedules the confirm inside a setTimeout so JS has a
  // chance to yield back to the binding, let `waitForEvent` register,
  // and capture the dialog. Without the delay the dialog fires
  // before the page finishes loading and the binding has no
  // listener yet.
  let script = r#"
    await page.goto("data:text/html,<script>setTimeout(()=>{document.title = confirm('sure?') ? 'yes' : 'no'}, 80)</script>");
    const dialog = await page.waitForEvent("dialog", 10000);
    const info = { type: dialog.type(), message: dialog.message() };
    await dialog.accept();
    // Give the page's setTimeout a moment to observe the accepted
    // confirm and update the title.
    for (let i = 0; i < 100; i++) {
      const t = await page.title();
      if (t === "yes" || t === "no") return { ...info, title: t };
      await new Promise(r => { let d = Date.now() + 25; while (Date.now() < d) {} });
    }
    return { ...info, title: await page.title() };
  "#;
  if c.backend == "webkit" {
    // WebKit's Obj-C host handles the response before Rust sees it.
    // The event may not reach waitForEvent inside the 10s window
    // because the dialog has already closed. Assert the typed
    // behaviour instead: accept/dismiss on the returned Dialog (if
    // any) surfaces the documented Unsupported error.
    let payload = c.script(script);
    let status = payload["status"].as_str().unwrap_or("");
    if status == "error" {
      let msg = payload["error"]["message"].as_str().unwrap_or("");
      assert!(
        msg.contains("Timeout") || msg.contains("not supported") || msg.contains("unsupported"),
        "webkit dialog path should surface Timeout or Unsupported, got: {msg}",
      );
    } else {
      // Dialog reached the listener anyway — accept should have
      // returned Unsupported (we rely on the title check).
      // No further assertion; title stays "no" because Obj-C dismissed.
    }
    return;
  }
  let v = c.script_value(script);
  assert_eq!(v["type"].as_str(), Some("confirm"), "dialog type: {v}");
  assert!(
    v["message"].as_str().is_some_and(|m| m.contains("sure")),
    "dialog message carries page text: {v}",
  );
  assert_eq!(v["title"].as_str(), Some("yes"), "accepting confirm → title 'yes': {v}");
}

/// `page.waitForEvent('dialog')` + `dialog.dismiss()` on a `confirm()`.
pub fn test_dialog_dismiss_confirm(c: &mut McpClient) {
  if c.backend == "webkit" {
    return; // See test_dialog_accept_confirm — same limitation.
  }
  let script = r#"
    await page.goto("data:text/html,<script>setTimeout(()=>{document.title = confirm('ok?') ? 'yes' : 'no'}, 80)</script>");
    const dialog = await page.waitForEvent("dialog", 10000);
    await dialog.dismiss();
    for (let i = 0; i < 100; i++) {
      const t = await page.title();
      if (t === "yes" || t === "no") return { title: t };
      await new Promise(r => { let d = Date.now() + 25; while (Date.now() < d) {} });
    }
    return { title: await page.title() };
  "#;
  let v = c.script_value(script);
  assert_eq!(v["title"].as_str(), Some("no"), "dismissing confirm → 'no': {v}");
}

/// `prompt` dialog — accept with custom text, page sees it. Also
/// exercises `defaultValue()` accessor.
pub fn test_dialog_prompt_with_text(c: &mut McpClient) {
  if c.backend == "webkit" {
    return;
  }
  let script = r#"
    await page.goto("data:text/html,<script>setTimeout(()=>{document.title = prompt('name?', 'alice') || 'null'}, 80)</script>");
    const dialog = await page.waitForEvent("dialog", 10000);
    const info = {
      type: dialog.type(),
      defaultValue: dialog.defaultValue(),
    };
    await dialog.accept("bob");
    for (let i = 0; i < 100; i++) {
      const t = await page.title();
      if (t && t !== "") return { ...info, title: t };
      await new Promise(r => { let d = Date.now() + 25; while (Date.now() < d) {} });
    }
    return { ...info, title: await page.title() };
  "#;
  let v = c.script_value(script);
  assert_eq!(v["type"].as_str(), Some("prompt"), "dialog type: {v}");
  assert_eq!(v["defaultValue"].as_str(), Some("alice"), "default: {v}");
  assert_eq!(v["title"].as_str(), Some("bob"), "accepted prompt text wins: {v}");
}

/// Second accept / dismiss on the same Dialog rejects with the
/// Playwright-exact message. Asserts the one-shot contract.
pub fn test_dialog_double_accept_rejects(c: &mut McpClient) {
  if c.backend == "webkit" {
    return;
  }
  let script = r#"
    await page.goto("data:text/html,<script>setTimeout(()=>{alert('once')}, 80)</script>");
    const dialog = await page.waitForEvent("dialog", 10000);
    await dialog.accept();
    let threw = false;
    let message = "";
    try {
      await dialog.accept();
    } catch (e) {
      threw = true;
      message = String(e && e.message || e);
    }
    return { threw, message };
  "#;
  let v = c.script_value(script);
  assert_eq!(v["threw"].as_bool(), Some(true), "second accept should reject: {v}");
  assert!(
    v["message"].as_str().is_some_and(|m| m.contains("already handled")),
    "rejection uses Playwright's exact wording: {v}",
  );
}

/// No listener registered → backend auto-dismisses the dialog so the
/// page's `confirm()` returns `false`. Proves the auto-close
/// Rule-4 honesty: we do not rely on the host's default behaviour,
/// we drive the dismiss ourselves.
pub fn test_dialog_auto_dismiss_without_listener(c: &mut McpClient) {
  if c.backend == "webkit" {
    return; // Obj-C host's WKUIDelegate auto-decides regardless.
  }
  c.nav_url("data:text/html,<script>document.title = confirm('no listener?') ? 'yes' : 'no'</script>");
  // No `waitForEvent` here — the page loads and the dialog auto-closes.
  let script = r"
    return { title: await page.title() };
  ";
  let v = c.script_value(script);
  assert_eq!(
    v["title"].as_str(),
    Some("no"),
    "without a dialog listener the backend auto-dismisses: {v}",
  );
}

/// `dialog.page()` resolves to the owning page. We navigate to a known
/// data URL, trigger a dialog, and assert the dialog's `page().url()`
/// matches the page we navigated. cdp / bidi wire the page back-reference
/// into the live Dialog handle; webkit's host auto-decides before the
/// event reaches Rust, so the handle may not arrive (asserted as the
/// documented Timeout there rather than skipped).
pub fn test_dialog_page_accessor(c: &mut McpClient) {
  let script = r#"
    await page.goto("data:text/html,<title>dlg</title><script>setTimeout(()=>{document.title = confirm('p?') ? 'y' : 'n'}, 80)</script>");
    const dialog = await page.waitForEvent("dialog", 10000);
    const dlgPage = dialog.page();
    const out = {
      hasPage: dlgPage != null,
      sameUrl: dlgPage != null ? (dlgPage.url() === page.url()) : false,
    };
    await dialog.accept();
    return out;
  "#;
  if c.backend == "webkit" {
    let payload = c.script(script);
    let status = payload["status"].as_str().unwrap_or("");
    if status == "error" {
      let msg = payload["error"]["message"].as_str().unwrap_or("");
      assert!(
        msg.contains("Timeout") || msg.contains("not supported") || msg.contains("unsupported"),
        "webkit dialog path should surface Timeout or Unsupported, got: {msg}",
      );
    }
    return;
  }
  let v = c.script_value(script);
  assert_eq!(v["hasPage"].as_bool(), Some(true), "dialog.page() returns a page: {v}");
  assert_eq!(
    v["sameUrl"].as_bool(),
    Some(true),
    "dialog.page().url() matches the owning page url: {v}",
  );
}