coderef

HTML setter methodsLimited availability

The setHTML(), replaceWithHTML(), beforeHTML(), prependHTML(), appendHTML() and afterHTML() DOM methods, and unsafe equivalents, insert HTML into an existing tree.

Not yet supported in all major browsers — check the table and provide a fallback.

How to use ↓Compare browsers

Browser support

DesktopChrome
✕Not supportedup to 155
Current: 155
Edge
✕Not supportedup to 154
Current: 154
Firefox
✕Not supportedup to 157
Current: 157
Safari
✕Not supportedup to 27
Current: 27
MobileChrome Android
✕Not supportedup to 155
Current: 155
Firefox Android
✕Not supportedup to 157
Current: 157
Safari iOS
✕Not supportedup to 27
Current: 27

How to use

Not supported in Chrome, Edge, Firefox, Safari, Chrome Android, Firefox Android, Safari iOS. Use feature detection below and provide a fallback (or a polyfill) for those browsers.

Example

Full syntax and examples are on MDN: setHTMLUnsafe.

Feature detection

JS · check before using
if ("TrustedHTMLParserOptions" in globalThis) {
  // TrustedHTMLParserOptions is available
} else {
  // load a polyfill or use a fallback
}

Documentation (MDN)

Specification

Sub-features

Support for each part of the feature (33). The overall table above shows when the whole feature works.

Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
CharacterData.afterHTML✕✕✕✕✕✕✕
CharacterData.afterHTMLUnsafe✕✕✕✕✕✕✕
CharacterData.beforeHTML✕✕✕✕✕✕✕
CharacterData.beforeHTMLUnsafe✕✕✕✕✕✕✕
CharacterData.replaceWithHTML✕✕✕✕✕✕✕
CharacterData.replaceWithHTMLUnsafe✕✕✕✕✕✕✕
Element.afterHTML✕✕✕✕✕✕✕
Element.afterHTMLUnsafe✕✕✕✕✕✕✕
Element.appendHTML✕✕✕✕✕✕✕
Element.appendHTMLUnsafe✕✕✕✕✕✕✕
Element.beforeHTML✕✕✕✕✕✕✕
Element.beforeHTMLUnsafe✕✕✕✕✕✕✕
Element.prependHTML✕✕✕✕✕✕✕
Element.prependHTMLUnsafe✕✕✕✕✕✕✕
Element.replaceWithHTML✕✕✕✕✕✕✕
Element.replaceWithHTMLUnsafe✕✕✕✕✕✕✕
Element.setHTMLUnsafe1241241232612412326
Element.setHTMLUnsafe.options_runscripts_parameter✕✕✕✕✕✕✕
ShadowRoot.afterHTML✕✕✕✕✕✕✕
ShadowRoot.afterHTMLUnsafe✕✕✕✕✕✕✕
Show 13 more
Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
ShadowRoot.appendHTML✕✕✕✕✕✕✕
ShadowRoot.appendHTMLUnsafe✕✕✕✕✕✕✕
ShadowRoot.beforeHTML✕✕✕✕✕✕✕
ShadowRoot.beforeHTMLUnsafe✕✕✕✕✕✕✕
ShadowRoot.prependHTML✕✕✕✕✕✕✕
ShadowRoot.prependHTMLUnsafe✕✕✕✕✕✕✕
ShadowRoot.replaceWithHTML✕✕✕✕✕✕✕
ShadowRoot.replaceWithHTMLUnsafe✕✕✕✕✕✕✕
ShadowRoot.setHTMLUnsafe1241241232612412326
ShadowRoot.setHTMLUnsafe.options_runscripts_parameter✕✕✕✕✕✕✕
TrustedHTMLParserOptions✕✕✕✕✕✕✕
TrustedHTMLParserOptions.runScripts✕✕✕✕✕✕✕
TrustedHTMLParserOptions.sanitizer✕✕✕✕✕✕✕