Skip to content

Instantly share code, notes, and snippets.

@amacneil
Last active March 18, 2021 03:24
Show Gist options
  • Star 18 You must be signed in to star a gist
  • Fork 1 You must be signed in to fork a gist
  • Save amacneil/5af7cd0e934f5465b695 to your computer and use it in GitHub Desktop.
Save amacneil/5af7cd0e934f5465b695 to your computer and use it in GitHub Desktop.
Safely JSON-encode objects in your Django template
from django.core.serializers.json import DjangoJSONEncoder
from django.template import Library
from json import dumps as json_dumps
register = Library()
@register.filter
def json(data):
"""
Safely JSON-encode an object.
To protect against XSS attacks, HTML special characters (<, >, &) and unicode newlines
are replaced by escaped unicode characters. Django does not escape these characters
by default.
Output of this method is not marked as HTML safe. If you use it inside an HTML
attribute, it must be escaped like regular data:
<div data-user="{{ data|json }}">
If you use it inside a <script> tag, then the output does not need to be escaped,
so you can mark it as safe:
<script>
var user = {{ data|json|safe }};
</script>
Escaped characters taken from Rails json_escape() helper:
https://github.com/rails/rails/blob/v4.2.5/activesupport/lib/active_support/core_ext/string/output_safety.rb#L60-L113
"""
unsafe_chars = {
'&': '\\u0026',
'<': '\\u003c',
'>': '\\u003e',
'\u2028': '\\u2028',
'\u2029': '\\u2029'}
json_str = json_dumps(data, cls=DjangoJSONEncoder)
for (c, d) in unsafe_chars.items():
json_str = json_str.replace(c, d)
return json_str
@acdha
Copy link

acdha commented Mar 1, 2016

@amacneil – thanks for contributing this. I was just looking to do the same thing & that saves the trouble. What license are you releasing this under – the same as Django core?

@therefromhere
Copy link

@amacneil I'd like to get this change applied to the Django-jsonify package, would you be happy for me to make a PR based on this gist? https://bitbucket.org/marltu/django-jsonify

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment