Service » Common params

Michael[tm] Smith edited this page Dec 27, 2016 · 2 revisions

The checker accepts the following parameters regardless of input method. How these parameters are communicated depends on the input method.

Note: The validator.nu deployment of the checker has a generic facet at https://validator.nu/ and an (X)HTML5 facet at https://html5.validator.nu/. Some parameters apply only to the generic facet. All parameters listed here are optional.

Parameters for all facets

out

Value Format
none HTML
xhtml XHTML
xml XML
json JSON
gnu GNU error format
text Human-readable text (not for machine parsing)

showsource

The only supported value is yes which means that source is shown (if supported by the output format).

level

The only supported value is error which means that only errors and non-document errors are reported. That is, informative messages including warnings are not reported.

nsfilter

Space-separated list of XML namespace URIs. Elements (and their children) and attributes in those namespaces are filtered out between the XML parser and the validation layer. The filtered elements participate in ID uniqueness checking. The filter doesn’t apply to HTML parser.

checkerrorpages

The only supported value is yes, which means that the checker will retrieve a document and check it even if the response from the server is a 404 or other non-200 status. Otherwise the checker will not retrieve the document but will instead emit a message indicating the document was not retrieved, along with the HTTP status code.

Parameters for the generic facet only

schema

This parameter takes a space-separated list of schema IRIs (http or https). The schemas can be RELAX NG 1.0 schemas, Schematron 1.5 schemas or identifiers for built-in non-schema-based checkers.

laxtype

The only supported value is yes which means that RFC 3023 character encoding defaults are disrespected and text/html is accepted as an XML MIME type.

parser

Value Meaning
none Choice of HTML or XML parser is based on Content-Type.
xml XML parser, will not load external entities
xmldtd XML parser, will load external entities
html HTML parser, configuration is based on doctype.
html5 HTML parser in the HTML5 mode.
html4 HTML parser in the HTML4 strict mode.
html4tr HTML parser in the HTML4 transitional mode.

Note: HTML parser configuration is based on doctype. XML parser does not load external entities. Note: The HTML4 modes of the HTML parser both emit additional errors for some HTML4 conformance requirements that are not HTML5 errors. The html4 mode insists on a HTML 4.01 Strict doctype, while the html4tr mode insists on HTML 4.01 Transitional doctype

Format-specific parameters

These parameters are specific to only some output formats.

asciiquotes

The only supported value is yes which means that ASCII quotes and apostrophes will be substituted for the Unicode smart quotes. This parameter only applies with out=text and out=gnu. The output may still contain Unicode characters in general.

callback

When this parameter is present, its value is taken to be the name of a JavaScript callback function to which the JSON object is given as an argument. This parameter only applies with out=json. The value must not be a JavaScript reserved word.

See also: Web Service Interface