How to Run Your First Browser Debug Session with Gasoline
This is the simplest full debug loop you can run with Gasoline Agentic Devtools.
You will go from “something is broken” to “I can prove where it breaks.”
Quick Terms
Section titled “Quick Terms”- Bug triage: Quickly finding and classifying what is broken.
- DOM (Document Object Model): The structured page content your browser renders.
Step 1: Open the page with the bug
Section titled “Step 1: Open the page with the bug”Start on the exact page where the issue happens.
Step 2: Capture baseline errors
Section titled “Step 2: Capture baseline errors”observe({what: "errors"})observe({what: "logs", min_level: "warn"})Step 3: Reproduce the issue intentionally
Section titled “Step 3: Reproduce the issue intentionally”Use explicit interaction steps:
interact({what: "navigate", url: "https://your-app.example"})Then click/type the steps that trigger the bug.
Step 4: Check failing requests
Section titled “Step 4: Check failing requests”observe({what: "network_waterfall", status_min: 400})observe({what: "network_bodies", status_min: 400})Step 5: Capture page evidence
Section titled “Step 5: Capture page evidence”observe({what: "screenshot", full_page: true})Step 6: Generate a repro artifact
Section titled “Step 6: Generate a repro artifact”generate({what: "reproduction"})Now you have reproducible evidence for engineering, quality assurance (QA), or support.
Image and Diagram Callouts
Section titled “Image and Diagram Callouts”[Image Idea] Side-by-side of errors, failing request, and screenshot evidence.
[Diagram Idea] Debug loop: reproduce -> observe -> isolate -> artifact.