dogfather-universe/server/helfer-nachfrage.mjs

/* =====================================================================
   helfer-nachfrage.mjs — Eine Rückfrage im Prüflauf bestätigen.

   Seit dem 19.09.2026 benutzt der Workspace keinen `confirm()` mehr,
   sondern einen eigenen <dialog> (`workspace/assets/js/nachfrage.js`).

   Für die Prüfungen ist das ein Bruch, und zwar ein lehrreicher:
   Playwright fängt `confirm()` selbst ab -- `seite.once("dialog", d =>
   d.accept())` reichte. Ein <dialog> ist dagegen ganz normales HTML.
   Wer den Knopf nur anklickt und weitergeht, bestätigt gar nichts; die
   Seite wartet still auf eine Antwort, die nie kommt.

   Genau das ist am 19.09. passiert: `pruef-chat-anhaenge` meldete
   plötzlich acht Fehler -- keiner davon im Code, alle daher, dass die
   Prüfung den neuen Dialog nicht kannte. Hätte ich sie für echt
   gehalten, hätte ich stundenlang an einer Stelle gesucht, an der
   nichts kaputt war.

   Deshalb steht das hier EINMAL statt fünfmal in Kopie.

   ---------------------------------------------------------------------
   BEIDE WEGE, ABSICHTLICH

   Der Helfer kommt mit beidem zurecht -- dem <dialog> UND einem
   nativen `confirm()`. Nicht aus Bequemlichkeit: `nachfrage.js` fällt
   auf `confirm()` zurück, wenn der Browser kein <dialog> kann (Safari
   vor 15.4). Ein Helfer, der nur den einen Weg kennt, könnte den
   Notnagel nie prüfen.

   AUFRUF:
     await bestaetige(seite, () => seite.click("#gespraech-weg"));
     await verwerfe(seite,  () => seite.click("#loeschen"));
   ===================================================================== */

/** Löst etwas aus und bestätigt die Rückfrage, die dabei aufgeht.
 *
 *  @param seite    die Playwright-Seite
 *  @param ausloesen  Funktion, die den Knopf drückt
 *  @param o.tippen   Text, der ins Abtippfeld muss (bei endgültigen
 *                    Handlungen wie „Person löschen")
 *  @param o.grund    Text für das Grundfeld, falls eines da ist
 *  @param o.zahl     Zahl für das Zahlenfeld, falls eines da ist
 *  @returns true, wenn eine Rückfrage kam und bestätigt wurde
 */
export async function bestaetige(seite, ausloesen, o = {}) {
  /* Den nativen Notnagel mitnehmen -- falls der Browser kein <dialog>
     kann, kommt die Frage auf diesem Weg. */
  let nativ = false;
  const fangNativ = (d) => { nativ = true; d.accept(o.tippen || o.grund || ""); };
  seite.once("dialog", fangNativ);

  await ausloesen();

  if (nativ) return true;

  /* Auf den eigenen Dialog warten. Kurze Frist: Er wird ohne
     Netzzugriff gebaut, er ist sofort da oder gar nicht. Eine lange
     Frist würde einen FEHLENDEN Dialog in eine Sekunde Wartezeit
     verwandeln statt in einen Befund. */
  try {
    await seite.waitForSelector("dialog.nachfrage[open]", { timeout: 2000 });
  } catch {
    seite.off?.("dialog", fangNativ);
    return nativ;   /* keine Rückfrage -- der Aufrufer entscheidet, ob das ein Fehler ist */
  }

  if (o.tippen !== undefined) await seite.fill("#nachfrage-tipp", o.tippen);
  if (o.eingabe !== undefined) await seite.fill("#nachfrage-tipp", o.eingabe);
  if (o.grund !== undefined) await seite.fill("#nachfrage-grund", o.grund);
  if (o.zahl !== undefined) await seite.fill("#nachfrage-zahl", String(o.zahl));

  await seite.click('dialog.nachfrage [data-teil="ja"]');
  /* Warten, bis er WIRKLICH zu ist. Ohne das läuft die nächste
     Prüfung gegen einen Bildschirm, über dem noch ein Dialog liegt --
     und meldet, ein Knopf sei nicht anklickbar. */
  await seite.waitForSelector("dialog.nachfrage[open]", { state: "hidden", timeout: 2000 });
  return true;
}

/** Dasselbe, aber die Rückfrage wird ABGELEHNT. Für Gegenproben:
 *  „Doch nicht" muss wirklich nichts tun. */
export async function verwerfe(seite, ausloesen) {
  let nativ = false;
  seite.once("dialog", (d) => { nativ = true; d.dismiss(); });
  await ausloesen();
  if (nativ) return true;
  try {
    await seite.waitForSelector("dialog.nachfrage[open]", { timeout: 2000 });
  } catch { return false; }
  await seite.click('dialog.nachfrage [data-teil="nein"]');
  await seite.waitForSelector("dialog.nachfrage[open]", { state: "hidden", timeout: 2000 });
  return true;
}

/** Was in der Rückfrage steht, ohne sie zu beantworten. Für Prüfungen,
 *  die belegen wollen, dass der Text wirklich sagt, was passiert. */
export async function nachfrageText(seite) {
  return seite.evaluate(() => {
    const d = document.querySelector("dialog.nachfrage[open]");
    if (!d) return null;
    const t = (n) => d.querySelector(`[data-teil="${n}"]`)?.textContent?.trim() || "";
    return {
      titel: t("titel"), was: t("was"), bleibt: t("bleibt"),
      endgueltig: !d.querySelector('[data-teil="endgueltig"]')?.hidden,
      ja: t("ja"), nein: t("nein"),
    };
  });
}