Ghost Inspector: validate a definition without saving or submitting
gi_validate_testValidate test definitions by running them in a real browser without saving or submitting forms, so you can confirm selectors resolve before editing.
Instructions
Runs a test definition through on-demand execution, which executes it and discards it ā nothing in the account is created or changed. Use it to check that a selector chain still resolves before editing a test, and to check a definition you are authoring before saving it.
š“ It drives a real browser against a real URL, so it is an action with real-world effects even though nothing is saved. Two guards apply and neither can be turned off. Modules are inlined first, because a test whose steps are just execute calls hides its submit inside a module and guarding the definition as written would miss it. Then the run is truncated at the first step that could submit a form, and that step is replaced by an assertion on the same target ā so the whole chain is verified, including that the submit control is reachable, without ever activating it. There is no way to make this tool submit; that stays a deliberate curl.
For an existing test the suite's viewport and browser are replicated, because tests inherit those and a selector can resolve on desktop and fail on mobile. Read ranAs.configSource to see what was actually used.
A browser run takes 20-100 seconds; the tool polls until it finishes. passing: null in the raw API means not finished, never failed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dryRun | No | Report exactly what would run ā after modules are inlined and the submit guard applied ā and stop. Nothing is sent to Ghost Inspector, no browser starts, no page loads, and no organization id is needed. Use it first on anything that touches production. | |
| testId | No | Existing test to validate. Its suite's viewport and browser are replicated. | |
| browser | No | Override, e.g. "chrome". Omit to replicate the suite's. | |
| viewport | No | Override, e.g. "1280x800". Omit to replicate the suite's. | |
| definition | No | Ad-hoc definition to validate instead of an existing test. |