Download this file
| 1 | // Package harness serves a fixture in a real Chromium: the browser rig |
| 2 | // behind `go test -tags browser ./...`. |
| 3 | // |
| 4 | // Every other file in this package is build-tagged `browser`. The root |
| 5 | // package promises that chromedp stays out of the ordinary build graph |
| 6 | // (`go list -deps .` pulls none of it), and an untagged package |
| 7 | // importing chromedp would make that sentence false the day it landed. |
| 8 | // This doc file is what keeps a plain `go build ./...` and |
| 9 | // `go vet ./...` seeing a valid package; the rig itself exists only |
| 10 | // under the tag. |
| 11 | // |
| 12 | // The shape is rastrillo's harness without the virtual authenticator |
| 13 | // (spec: rastrillo's docs/superpowers/specs/2026-08-23-harness-design.md): |
| 14 | // New binds a localhost listener first, hands the fixture its origin, |
| 15 | // then launches Chromium; watchers make every console error, failed |
| 16 | // request and 4xx/5xx a test failure; Screen gates each screen behind |
| 17 | // the junk scan, the bug class that renders perfectly and says nothing. |
| 18 | package harness |
| 19 | |
amadan