CSSStyleSheet: Methode replaceSync()

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die replaceSync()-Methode der CSSStyleSheet-Schnittstelle ersetzt synchron den Inhalt des Stylesheets mit dem übergebenen Inhalt.

Die Methoden replaceSync() und CSSStyleSheet.replace() können nur bei einem Stylesheet verwendet werden, das mit dem CSSStyleSheet()-Konstruktor erstellt wurde.

replaceSync(text)

text: Ein String, der die Stilregeln enthält, um den Inhalt des Stylesheets zu ersetzen. Wenn der String keine parsbare Liste von Regeln enthält, wird der Wert auf einen leeren String gesetzt.

Hinweis: Wenn eine der in text übergebenen Regeln ein externes Stylesheet ist, das mit der @import-Regel importiert wurde, werden diese Regeln entfernt, und eine Warnung wird in die Konsole ausgegeben.

Keiner (undefined).

NotAllowedError DOMException: Wird ausgelöst, wenn das Stylesheet nicht mit dem CSSStyleSheet()-Konstruktor erstellt wurde oder das Stylesheet als nicht modifizierbar gekennzeichnet ist.

Im folgenden Beispiel wird ein neues Stylesheet erstellt und zwei CSS-Regeln werden mit replaceSync hinzugefügt.

const stylesheet = new CSSStyleSheet();

stylesheet.replaceSync("body { font-size: 1.4em; } p { color: red; }");

Specification
CSS Object Model (CSSOM) # dom-cssstylesheet-replacesync

BCD tables only load in the browser