CSSStyleSheet: replace() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2023年3月以降、すべてのブラウザーで利用可能です。

replace() は CSSStyleSheet インターフェイスのメソッドで、スタイルシートの内容を渡された内容で非同期に置き換えます。このメソッドは CSSStyleSheet オブジェクトで解決されるプロミスを返します。

replace() と CSSStyleSheet.replaceSync() の両メソッドは、 CSSStyleSheet() コンストラクターで作成されたスタイルシートでのみ使用できます。

構文

replace(text)

引数

text: スタイルシートのコンテンツを置き換えるためのスタイルルールを格納した文字列。文字列に解釈可能なルールのリストが入っていない場合、値は空文字列に設定されます。

メモ: もし text に渡されたルールの中に @import ルールでインポートされた外部スタイルシートがあった場合は、それらのルールは除去され、コンソールに警告が出力されます。

返値

Promise で、 CSSStyleSheet に解決します。

例外

NotAllowedError DOMException

次の 2 つの条件のうち一方が成立した場合に発生します。

このスタイルシートが CSSStyleSheet() コンストラクターを使用して作成されていない。
このスタイルシートが変更不可に設定されている。

例

次の例では、新しいスタイルシートを作成し、replace() を使って 2 つの CSS ルールを追加しています。最初のルールはコンソールに 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);
  });

仕様書

仕様書
CSS Object Model (CSSOM) # dom-cssstylesheet-replace

ブラウザーの互換性

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって 2025年6月24日に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告