Auto XML-Escaping
Auto-escaping is an important feature of Squirrelly. When it's enabled, every reference without the safe
filter or *
prefix will be HTML-escaped, to provide some protection against XSS.
caution
Squirrelly has not been vetted for security, and autoEscaping is probably not completely foolproof. We use the same function as many other template engines, like Mustache and Handlebars, but there's still the possibility that there's some vulnerability.
Disabling
To avoid escaping a specific reference, you can pass it through the safe
filter.
Example: {{someref | safe}}
You can also put an asterisk (*
) after the opening delimiters and whitespace control tags.
Examples: {{* someref}}
, {{_ * someref}}
note
Auto-escaping can be helpful, but it also negatively impacts performance. For best results, autoEscape data before you store it or attempt to render it in a template.