No timing guesswork

The usual fallback is sleep(3) and hope. Instead there is /wait: wait until a form appears, until a control becomes enabled, until it is gone, or until the main thread goes quiet. It answers 200 when the condition held and 408 when it never did — and reports how long it actually took.

Kein Raten über Zeiten

Der übliche Notbehelf ist sleep(3) und Hoffen. Stattdessen gibt es /wait: warten, bis ein Formular erscheint, bis ein Element bedienbar ist, bis es verschwunden ist, oder bis der Hauptthread zur Ruhe kommt. Antwort 200, wenn die Bedingung eintrat, 408, wenn nicht — samt der tatsächlich vergangenen Zeit.

Refusals instead of false positives

Triggering a disabled action returns 409, not a cheerful „done“. A test that asks for something impossible learns that it was impossible — the single most valuable property when nobody is watching the screen.

Absagen statt Scheinerfolge

Eine gesperrte Aktion auslösen ergibt 409, kein fröhliches „erledigt“. Ein Test, der Unmögliches verlangt, erfährt, dass es unmöglich war — die wertvollste Eigenschaft überhaupt, wenn niemand auf den Bildschirm sieht.

Modal dialogs don’t block

An action that opens a modal dialog would never return. With async=1 it is queued and answered immediately with 202 — checked first, so a disabled action is still refused. Message boxes can be answered in advance and are logged with their text, which is often worth more than the click.

Modale Dialoge blockieren nicht

Eine Aktion, die einen modalen Dialog öffnet, käme nie zurück. Mit async=1 wird sie vorgemerkt und sofort mit 202 beantwortet — vorher geprüft, eine gesperrte Aktion wird weiterhin abgelehnt. Meldungsdialoge lassen sich im Voraus beantworten und werden mit ihrem Text protokolliert, was oft mehr wert ist als der Klick.

Write, then read back

Setting a property answers with the value read back from the object, not with a confirmation. Some properties clamp or reformat what you give them, and that is precisely what the caller needs to know.

Schreiben und zurücklesen

Eine Eigenschaft zu setzen liefert den vom Objekt zurückgelesenen Wert, keine Bestätigung. Manche Eigenschaften begrenzen oder formatieren, was man ihnen gibt — und genau das muss der Aufrufer erfahren.

Nothing has to be known in advance

/objects lists every component the application holds — including the ones that never appear on screen: datasets, timers, action lists, whole data modules. Each with the path that addresses it unambiguously, even when two modules use the same name.

class=TDataSet&derived=1 narrows it to every dataset, whatever the application happens to use. Catalogue first, then drive — without ever having seen the source.

Man muss nichts vorher wissen

/objects listet jede Komponente der Anwendung — auch die, die nie auf dem Bildschirm auftauchen: Datenmengen, Timer, Aktionslisten, ganze Datenmodule. Jede mit dem Pfad, der sie eindeutig anspricht, auch wenn zwei Module denselben Namen benutzen.

class=TDataSet&derived=1 engt auf alle Datenmengen ein, gleich welche die Anwendung verwendet. Erst katalogisieren, dann steuern — ohne den Quelltext je gesehen zu haben.

Data that survives the round trip

A dataset row comes back typed: numbers as numbers, booleans as true, dates as 2026-12-24, an empty field as null. Exactly what goes back in when you write it again — no conversion by hand, and no dependence on the Windows locale of whichever machine the test happens to run on.

Daten, die den Rundlauf überstehen

Eine Datensatzzeile kommt typisiert zurück: Zahlen als Zahl, Wahrheitswerte als true, Datumsangaben als 2026-12-24, ein leeres Feld als null. Genau das, was beim Zurückschreiben wieder hineingeht — ohne Umrechnen von Hand und ohne Abhängigkeit von den Ländereinstellungen der Maschine, auf der der Test gerade läuft.

Names, not coordinates

Controls are addressed by name or by path (frmMain.pnlLeft.btnSave). Clicking goes through the control’s own Click method, so it works while the window is covered or in the background — and hits the intended element every time.

Namen statt Koordinaten

Steuerelemente werden über Namen oder Pfad angesprochen (frmMain.pnlLeft.btnSave). Der Klick geht über die Click-Methode des Elements und wirkt auch bei verdecktem oder im Hintergrund liegendem Fenster — und trifft immer das gemeinte.

Typing that doesn’t need the window in front

/key?control=edtTotal&text=12,50 sends the keystrokes straight to that element — in the background, covered, whatever. And the answer only goes out once the control has processed them, so reading the value back is not a race.

Real system input stays available for Ctrl+S and the like. But it goes wherever Windows thinks the focus is, so if the application is not in front, that call refuses rather than typing into a stranger’s window.

Tippen, ohne das Fenster nach vorn zu holen

/key?control=edtTotal&text=12,50 schickt die Eingabe direkt an das Element — im Hintergrund, verdeckt, egal. Und die Antwort geht erst hinaus, wenn das Steuerelement sie verarbeitet hat: Zurücklesen ist damit kein Wettlauf.

Echte Systemeingabe bleibt für Strg+S und Verwandtes. Die geht aber dorthin, wo Windows den Fokus sieht — liegt die Anwendung nicht vorn, sagt dieser Aufruf ab, statt in ein fremdes Fenster zu schreiben.

Screenshots when they help

For the genuinely visual checks — colours, layout, a rendered label — /screenshot captures a window through PrintWindow, so the image is right even when the window is covered. The picture complements the facts; it no longer replaces them.

Bildschirmfotos, wo sie helfen

Für wirklich Visuelles — Farben, Layout, ein gerendertes Etikett — nimmt /screenshot ein Fenster über PrintWindow auf; das Bild stimmt auch bei Verdeckung. Es ergänzt die Fakten, statt sie zu ersetzen.

VCL only

It reads the VCL component tree. Application.MessageBox is a plain Win32 window without a VCL form and therefore out of reach; so is anything drawn by a control that keeps its state to itself.

Nur VCL

Gelesen wird der VCL-Komponentenbaum. Application.MessageBox ist ein reines Win32-Fenster ohne VCL-Formular und damit nicht erreichbar — ebenso wenig, was ein Steuerelement nur für sich selbst zeichnet.

Setting is not typing

A property set through the interface does not raise the same events as a real keystroke. Where validation hangs off OnChange, use /key instead — the component documents the difference rather than hiding it.

Setzen ist nicht Tippen

Eine gesetzte Eigenschaft löst nicht dieselben Ereignisse aus wie eine echte Eingabe. Wo die Prüfung an OnChange hängt, führt /key zum Ziel — die Komponente dokumentiert den Unterschied, statt ihn zu verbergen.

It waits with the application

If the main thread is busy, so is the interface. That is deliberate — but it means the component cannot be used to inspect an application that has hung.

Es wartet mit der Anwendung

Ist der Hauptthread beschäftigt, wartet auch die Schnittstelle. Das ist gewollt — heißt aber, dass sich eine hängende Anwendung damit nicht untersuchen lässt.