Accessibility Test Harness

List all recorded accessibility test results

{
  "data": [
    {
      "id": "at-001",
      "test_type": "semantic_label",
      "widget_key": "submit-btn-001",
      "passed": true,
      "run_at": "2026-03-26T08:10:00Z"
    },
    {
      "id": "at-002",
      "test_type": "focus_traversal",
      "widget_key": "login-form",
      "passed": false,
      "run_at": "2026-03-26T08:12:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 2
  }
}

Get details of a specific accessibility test result

{
  "id": "at-002",
  "test_type": "focus_traversal",
  "widget_key": "login-form",
  "passed": false,
  "failure_reason": "Focus skipped 'password-field' widget during traversal",
  "traversal_order": [
    "email-field",
    "forgot-password-link",
    "submit-btn"
  ],
  "run_at": "2026-03-26T08:12:00Z"
}

Run an accessibility test against a widget or semantic tree

{
  "test_type": "semantic_label",
  "widget_key": "close-modal-btn",
  "expected_label": "Close appointment details dialog"
}

{
  "id": "at-003",
  "test_type": "semantic_label",
  "widget_key": "close-modal-btn",
  "expected_label": "Close appointment details dialog",
  "passed": true,
  "actual_label": "Close appointment details dialog",
  "run_at": "2026-03-26T11:55:00Z"
}

Update expected values on a test fixture for re-run

{
  "expected_label": "Close dialog"
}

{
  "id": "at-003",
  "test_type": "semantic_label",
  "widget_key": "close-modal-btn",
  "expected_label": "Close dialog",
  "passed": null,
  "updated_at": "2026-03-26T11:56:00Z"
}

Delete a test result record

{
  "message": "Test result at-003 deleted"
}

Simulate focus traversal on a widget tree and return the traversal order

{
  "widget_key": "registration-form",
  "session_id": "sess-abc123"
}

{
  "widget_key": "registration-form",
  "traversal_order": [
    "first-name-field",
    "last-name-field",
    "email-field",
    "password-field",
    "terms-checkbox",
    "register-btn"
  ],
  "total_focusable": 6,
  "issues": [],
  "passed": true
}

Assert that an expected message was announced to the active screen reader

{
  "expected_message": "Password reset email sent",
  "session_id": "sess-abc123"
}

{
  "expected_message": "Password reset email sent",
  "announced": true,
  "actual_message": "Password reset email sent",
  "announced_at": "2026-03-26T10:30:05Z",
  "verified": true
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}