CSSStyleSheet: replaceSync() method
Baseline
Widely available
This feature is well established and works across many devices and browser versions. Itâs been available across browsers since â¨March 2023â©.
The replaceSync() method of the CSSStyleSheet interface synchronously replaces the content of the stylesheet with the content passed into it.
The replaceSync() and CSSStyleSheet.replace() methods can only be used on a stylesheet created with the CSSStyleSheet() constructor.
Syntax
replaceSync(text)
Parameters
text-
A string containing the style rules to replace the content of the stylesheet. If the string does not contain a parsable list of rules, then the value will be set to an empty string.
Note: If any of the rules passed in
textare an external stylesheet imported with the@importrule, those rules will be removed, and a warning printed to the console.
Return value
None (undefined).
Exceptions
NotAllowedErrorDOMException-
Thrown if the stylesheet was not created using the
CSSStyleSheet()constructor or if the stylesheet is flagged as unmodifiable.
Examples
In the following example a new stylesheet is created and two CSS rules are added using replaceSync.
const stylesheet = new CSSStyleSheet();
stylesheet.replaceSync("body { font-size: 1.4em; } p { color: red; }");
Specifications
| Specification |
|---|
| CSS Object Model (CSSOM) # dom-cssstylesheet-replacesync |