FeaturePOST /v1/assert

Assert API

Mehrere DOM-Regeln in einer Navigation — Pass/Fail mit results[] für CI und Smoke-Tests.

Was du mit Assert machen kannst

Mehrere DOM-Regeln in einer Navigation: sichtbar, Text, Counts, Href, Attribute — Pass/Fail inkl. soft fails für CI-Gates und Smoke-Tests.

Bis zu 25 Regeln pro Call
Operatoren: visible, exists, count_min/max, contains, matches, href_contains, attr, …
Soft-Fails, die nicht den gesamten Lauf killen
Klarer passed-Boolean plus results[]

API Call

editable

Request body

{'{'}

{'}'}

Zwei Regeln in einem Call — Selector, visible und count_min sind editierbar.

Response

Noch nicht ausgeführt

h1 visible=true · a count_min=1

Endpoints & Parameter

Endpoint wählen — darunter siehst du eine beispielhafte Anfrage und die Erklärung aller relevanten Parameter.

POST /v1/assert

Multi-Rule Assertions nach einem Page-Load.

Beispiel-Anfrage

json

{
  "url": "https://example.com/pricing",
  "width": 1280,
  "height": 720,
  "scroll_into_view": true,
  "dismiss_cookie_banner": true,
  "assert": [
    {
      "selector": "h1",
      "visible": true,
      "contains": "Pricing"
    },
    {
      "selector": "a[href*=\"signup\"]",
      "visible": true,
      "href_contains": "signup"
    },
    {
      "selector": ".plan",
      "count_min": 3
    }
  ]
}

Parameter

urlstring required
Ziel-URL.
assertarray (1–25) required
Regeln; jede braucht selector.
assert[].visible / exists / not_coveredboolean
Sichtbarkeits-/Existenz-Erwartungen.
assert[].count / count_min / count_maxnumber
Anzahl-Erwartungen.
assert[].contains / text / matchesstring
Textinhalt prüfen.
assert[].href_contains / attrvarious
Link- und Attribut-Checks.
assert[].softboolean
Soft-Fail zählt, killt aber nicht passed.
scroll_into_view / ignore_selectorsvarious
Hilfen für Overlays.
width / heightnumber
Viewport.
dismiss_cookie_bannerboolean
Versucht bekannte Cookie-Banner zu schließen, bevor gemessen/geprüft wird.
wait_for_selectorstring
Wartet auf CSS-Selector, bevor weitergemacht wird.
wait_ms / settle_msnumber
Zusätzliche Wartezeit nach dem Laden (je nach Endpoint).
devicestring
Playwright-Device-Preset; überschreibt width/height/UA wenn gesetzt.
color_scheme'light'|'dark'|'no-preference'
Bevorzugtes Farbschema im Browser.
block_adsboolean
Blockiert bekannte Ad-/Tracker-Requests.
record_harboolean
Zeichnet optional HAR auf (wo vom Endpoint unterstützt).
respect_robotsboolean
Robots.txt beachten (Default: an).