TrustedHTML: toString() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Note: This feature is available in Web Workers.

The toString() method of the TrustedHTML interface returns a string which may safely inserted into an injection sink.

Syntax

js
toString()

Parameters

None.

Return value

A string containing the sanitized HTML.

Examples

The constant escaped is an object created via the Trusted Types policy escapeHTMLPolicy. The toString() method returns a string to safely insert into a document.

js
const escapeHTMLPolicy = trustedTypes.createPolicy("myEscapePolicy", {
  createHTML: (string) => string.replace(/</g, "&lt;"),
});

const escaped = escapeHTMLPolicy.createHTML("<img src=x onerror=alert(1)>");
console.log(escaped.toString());

Specifications

Specification
Trusted Types
# trustedhtml-stringification-behavior

Browser compatibility

BCD tables only load in the browser