Raw Checks

A Raw Check contains the raw output of a web page check, unprocessed, as returned by the Axe Core checker or the W3C HTML validator.

Rocket Validator processes the raw checks to extract the issues and present them in a more user-friendly way in the web interface. However, you can also access the raw checks if you need to process them in your own way.

Requesting store of raw checks

If not told otherwise, the raw checks are not stored and are deleted after they've been processed to generate the HTML and accessibility issues.

If you need to keep the raw checks for later processing, you can request these options when you create the report:

store_raw_html_checks: true
store_raw_a11y_checks: true

Credit cost for raw checks

Storing raw checks costs no extra credits. You're charged for the engine run that produced each raw result, whether or not you keep it.

For example, a report with HTML and accessibility checks on 10 web pages consumes 20 credits (10 HTML checks and 10 accessibility checks), with or without raw storage enabled. See Credits for the full breakdown.

Please consider not storing raw checks unless you need them, or only storing the kind of raw checks you need (HTML and / or accessibility).

Attributes

ID

Unique ID for this raw check.

Kind

Type of the raw check, either html or a11y.

Raw

Raw data of the check, as returned by the Axe Core checker or the W3C HTML validator.

Example

Example: HTML Raw Check

{
  "data": {
    "attributes": {
      "kind": "html",
      "raw": {
        "language": "en",
        "messages": [
          {
            "extract": "t=\"UTF-8\"><script type=\"text/javascript\">(windo",
            "firstColumn": 24,
            "hiliteLength": 31,
            "hiliteStart": 10,
            "lastColumn": 54,
            "lastLine": 4,
            "message": "The \u201ctype\u201d attribute is unnecessary for JavaScript resources.",
            "subType": "warning",
            "type": "info"
          },
          {
            "extract": "on.ico\">\n\t<meta name='robots' content='index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1' />\n\n\t<!-",
            "firstColumn": 2,
            "hiliteLength": 109,
            "hiliteStart": 10,
            "lastColumn": 110,
            "lastLine": 9,
            "message": "Trailing slash on void elements has no effect and interacts badly with unquoted attribute values.",
            "type": "info"
          }
        ],
        "url": "https://github.blog/ai-and-ml/generative-ai/how-ai-code-generation-works/"
      }
    },
    "id": "14691003",
    "type": "raw_check"
  },
  "jsonapi": {
    "version": "1.0"
  }
}

Get the HTML Raw Check for a Web Page

To get the HTML raw check for a web page, use the following endpoint:

Example: get the HTML raw check for a web page

GET /api/v1/reports/{{REPORT_ID}}/web_pages/{{WEB_PAGE_ID}}/raw_html_check

Get the Accessibility Raw Check for a Web Page

To get the accessibility raw check for a web page, use the following endpoint:

Example: get the accessibility raw check for a web page

GET /api/v1/reports/{{REPORT_ID}}/web_pages/{{WEB_PAGE_ID}}/raw_a11y_check

JSON output of W3C HTML Validator

For more information about the JSON output of the W3C HTML Validator, see the W3C HTML Validator documentation.

JSON output of Axe Core

The results object of Axe Core contains not only the violations found, but also the incomplete (also known as "review items") and passing checks. You can learn more about the Axe Core results object in the Axe Core documentation.