Skip to main content
When a run goes red with forty failures, they are usually not forty problems. top-errors collapses the failing tests onto the error log they share and orders the groups by how many tests each one took down, so the largest cause is the first thing you read. For fields and response details, see the API reference.
Sample output on this page uses --json. The pretty format for this command is a block per error rather than a table, because logs span several lines and the affected tests are nested. See Output formats.

top-errors list

Lists the run’s errors, most affected tests first.

Required arguments

  • <run_id> - the run whose errors to group, from runs list.
  • --project <project_id> - the project the run belongs to.
Sample output
test_entity_ids names every test in the group. test_entities describes a capped subset of them, so on a large group the two differ in length - read any test beyond the described ones with test-entities get. The pretty format makes this explicit by printing a +N more line with the remaining ids. The error log is the grouping key with Playwright’s per-test Call log: section stripped, which is what lets tests that failed the same way land in the same group. The response is not paginated and returns at most 20 groups.