# What it finds

Each finding is one sentence that names the element and, where it can, says by how much.

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://hraness.github.io/ra/media/ra-look-dark.png">
  <img src="https://hraness.github.io/ra/media/ra-look.png" width="830" alt="A phone screenshot of ra's broken fixture page with seven numbered problems, beside the sentences ra printed for them: the page scrolls sideways by 531px, a button's label is cut off by 84px, a long word runs 119px past its box, two lines are drawn over each other, a Pay now button is covered by another element, two tap targets are 18 by 18 pixels, and grey text has 1.9:1 contrast.">
</picture>

That is `ra look broken --at phone` on [a fixture page](https://github.com/hraness/ra/blob/main/test/fixtures/site/broken.html) of planted problems. It printed 37 findings, and the picture shows seven. There are 19 kinds:

- **Layout:**
  - [`page-scroll`](https://hraness.github.io/ra/docs/findings/#page-scroll): the page scrolls sideways.
  - [`cut-off`](https://hraness.github.io/ra/docs/findings/#cut-off): text or a control is clipped by a box that hides overflow.
  - [`spill`](https://hraness.github.io/ra/docs/findings/#spill): text runs out of its box.
  - [`overlap`](https://hraness.github.io/ra/docs/findings/#overlap): two pieces of text are painted over each other.
  - [`covered`](https://hraness.github.io/ra/docs/findings/#covered): something sits on top of a control, so a click would land on that instead.
- **Reading and reaching:**
  - [`contrast`](https://hraness.github.io/ra/docs/findings/#contrast): text has too little contrast with what is painted behind it.
  - [`small-target`](https://hraness.github.io/ra/docs/findings/#small-target): tap targets on touch views are small and crowded.
  - [`no-name`](https://hraness.github.io/ra/docs/findings/#no-name): a control has no accessible name, or an image has no alt text.
- **Content:**
  - [`image`](https://hraness.github.io/ra/docs/findings/#image): an image did not load, or is stretched.
  - [`blank`](https://hraness.github.io/ra/docs/findings/#blank): the page shows nothing.
  - [`document`](https://hraness.github.io/ra/docs/findings/#document): there is no title or viewport, or the status is unexpected.
  - [`error-overlay`](https://hraness.github.io/ra/docs/findings/#error-overlay): a dev-server error overlay is showing.
- **Behaviour:**
  - [`console`](https://hraness.github.io/ra/docs/findings/#console): an error was logged.
  - [`request`](https://hraness.github.io/ra/docs/findings/#request): a request failed or answered 4xx/5xx.
  - [`outside`](https://hraness.github.io/ra/docs/findings/#outside): a request left the world.
  - [`load`](https://hraness.github.io/ra/docs/findings/#load): the page did not load.
  - [`busy`](https://hraness.github.io/ra/docs/findings/#busy): the page never went quiet.
  - [`expect` and `steps`](https://hraness.github.io/ra/docs/findings/#expect-and-steps): your own checks or steps failed.

A false alarm sends an agent to change a page that was right, so ra counts one as a bug. Its twin fixture, [`tricky.html`](https://github.com/hraness/ra/blob/main/test/fixtures/site/tricky.html), holds 14 sections of things that only look wrong, such as deliberate ellipses, line clamps, scrolling strips, off-screen drawers, and screen-reader-only text. ra's tests fail if it reports anything there, at desktop or phone size, in dark mode, with scripts off, or after a jump down the page. [docs/findings.md](https://hraness.github.io/ra/docs/findings/) says how each kind is decided, what it deliberately leaves alone, and how to accept one.
