CSSOM
The replace() method of the CSSStyleSheet interface asynchronously replaces the content of the stylesheet with the content passed into it. The method returns a promise that resolves with the CSSStyleSheet object.
The replace() and CSSStyleSheet.replaceSync() methods can only be used on a stylesheet created with the CSSStyleSheet.CSSStyleSheet() constructor.
Syntax
replace(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 @import rule, those rules will be removed, and a warning printed to the console.
-
Return value
A Promise that resolves with the CSSStyleSheet.
Exceptions
NotAllowedErrorDOMException- : Thrown if one of these two conditions is met:
- The stylesheet was not created using the CSSStyleSheet.CSSStyleSheet() constructor.
- The stylesheet is flagged as unmodifiable.
- : Thrown if one of these two conditions is met:
Examples
In the following example a new stylesheet is created and two CSS rules are added using replace(). The first rule is then printed to the console, which will return: body { font-size: 1.4em; }
const stylesheet = new CSSStyleSheet();
stylesheet
.replace("body { font-size: 1.4em; } p { color: red; }")
.then(() => {
console.log(stylesheet.cssRules[0].cssText);
})
.catch((err) => {
console.error("Failed to replace styles:", err);
});
Specifications
Browser compatibility
See also
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
