# san/no-parsing-error

disallow parsing errors in <template>

  • ⚙️ This rule is included in all of "plugin:san/essential", "plugin:san/strongly-recommended" and "plugin:san/recommended".

This rule reports syntax errors in <template>. For example:

  • Syntax errors of scripts in directives.
  • Syntax errors of scripts in mustaches.
  • Syntax errors of HTML.

# 📖 Rule Details

This rule tries to parse directives/mustaches in <template> by the parser which parses <script>. Then reports syntax errors if exist.

<template> <!-- ✗ BAD --> {{ . }} {{ foo bar }} <div class={{*abc*}} / on-click="def("> </span> </div id="ghi"> <span s-html="'&#xe733'" /> </template>
Now loading...

character reference must be terminated by a U+003B (;) code point. https://html.spec.whatwg.org/multipage/parsing.html#hexademical-character-reference-state

# 🔧 Options

{
  "san/no-parsing-error": ["error", {
    "abrupt-closing-of-empty-comment": true,
    "absence-of-digits-in-numeric-character-reference": true,
    "cdata-in-html-content": true,
    "character-reference-outside-unicode-range": true,
    "control-character-in-input-stream": true,
    "control-character-reference": true,
    "eof-before-tag-name": true,
    "eof-in-cdata": true,
    "eof-in-comment": true,
    "eof-in-tag": true,
    "incorrectly-closed-comment": true,
    "incorrectly-opened-comment": true,
    "invalid-first-character-of-tag-name": true,
    "missing-attribute-value": true,
    "missing-end-tag-name": true,
    "missing-semicolon-after-character-reference": true,
    "missing-whitespace-between-attributes": true,
    "nested-comment": true,
    "noncharacter-character-reference": true,
    "noncharacter-in-input-stream": true,
    "null-character-reference": true,
    "surrogate-character-reference": true,
    "surrogate-in-input-stream": true,
    "unexpected-character-in-attribute-name": true,
    "unexpected-character-in-unquoted-attribute-value": true,
    "unexpected-equals-sign-before-attribute-name": true,
    "unexpected-null-character": true,
    "unexpected-question-mark-instead-of-tag-name": true,
    "unexpected-solidus-in-tag": true,
    "unknown-named-character-reference": true,
    "end-tag-with-attributes": true,
    "duplicate-attribute": true,
    "end-tag-with-trailing-solidus": true,
    "non-void-html-element-start-tag-with-trailing-solidus": false,
    "x-invalid-end-tag": true,
    "x-invalid-namespace": true
  }]
}

You can disable HTML syntax errors by options. Please see WHATWG HTML spec (opens new window) to know the details of HTML syntax errors. Only non-void-html-element-start-tag-with-trailing-solidus is disabled by default because San.js supports self-closing tags.

Note

This rule does not support all of those (E.g., it does not catch errors about DOCTYPE).

The error codes which have x- prefix are original of this rule because errors in tree construction phase have not codified yet.

# 📚 Further Reading

# 🔍 Implementation

Last Updated: 10/26/2021, 7:23:11 AM