Sanitizer

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The Sanitizer interface of the HTML Sanitizer API provides methods to sanitize untrusted strings of HTML, Document and DocumentFragment objects. After sanitization, unwanted elements or attributes are removed, and the returned objects can safely be inserted into a document's DOM.

A Sanitizer object is also used by the Element.setHTML() method to parse and sanitize a string of HTML, and immediately insert it into an element.

The default configuration strips out XSS-relevant input by default, including <script> tags, custom elements, and comments. This configuration may be customized using constructor options.

Constructors

Sanitizer()

Creates and returns a Sanitizer object, optionally with custom sanitization behavior.

Methods

Sanitizer.sanitize()

Returns a sanitized DocumentFragment from an input Document or DocumentFragment

Sanitizer.sanitizeFor()

Parses a string of HTML in the context a particular element, and returns an HTML element of that type containing the sanitized subtree.

Examples

For examples see the HTML Sanitizer API and the individual methods.

Specifications

Specification
HTML Sanitizer API
# sanitizer-api

Browser compatibility

BCD tables only load in the browser