コンテンツにスキップ
svelte-vitalssvelte-vitals

レポーター

svelte-vitals は 7 つの出力レポーターをサポートしています。--reporter <fmt> で選択するか、環境に適したものを自動選択に任せてください。

利用可能なレポーター

Section titled “利用可能なレポーター”

console（デフォルト）

Section titled “console（デフォルト）”

ターミナル使用に適した、人間が読みやすいテキスト出力です。重大度ごとに検出結果をグループ化し、ルートパスとファイルの場所を含みます。

Terminal window
svelte-vitals --reporter console

json

Section titled “json”

マシン可読な JSON 出力。スクリプト、ダッシュボード、または他のツールへの結果のフィードに便利です。

Terminal window
svelte-vitals --reporter json

agent

Section titled “agent”

AI コーディングエージェント向けに設計された Markdown 修正ドキュメントです。各失敗した検出結果には以下が含まれます：

  • ルートとソースファイルの場所
  • スニペット付きの具体的なコード修正
  • 受け入れチェック

agent レポーターは、既知の AI エージェント環境（例：Claude Code が CLAUDECODE を設定）が検出された場合に自動選択されます。自動選択された場合（明示的にリクエストされていない場合）、上書き方法を説明する 1 行のヒントが stderr に表示されます。

Terminal window
svelte-vitals --reporter agent

環境変数で自動選択を上書きする：

Terminal window
SVELTE_VITALS_REPORTER=agent svelte-vitals

sarif

Section titled “sarif”

SARIF v2.1 形式。GitHub Code Scanning、Azure DevOps、その他 SARIF を使用する SAST ツールと互換性があります。

Terminal window
svelte-vitals --reporter sarif

github

Section titled “github”

GitHub Actions の ワークフローコマンド 形式。プルリクエストにインラインで表示される ::error および ::warning アノテーションを出力します。

github レポーターは GITHUB_ACTIONS=true が設定されている場合（GitHub Actions が自動的に設定）に自動選択されます。

Terminal window
svelte-vitals --reporter github

md

Section titled “md”

コンパクトな Markdown サマリーです — Health スコア、カテゴリ別スコア表、重大度別件数、 各ルールのドキュメントページへのリンク付き検出結果テーブルを含みます。GitHub Actions の ジョブサマリーや PR コメント向けに設計されており、GitHub のコメントサイズ制限内に収まるよう 検出結果の行数は 50 件に制限されます。このレポーターを自動的にワークフローへ組み込む svelte-vitals ci install については CI 連携ガイド を 参照してください。

Terminal window
svelte-vitals --reporter md

HTML レポート

Section titled “HTML レポート”

--reporter html は、ブラウザで開ける自己完結の HTML レポートを出力します。これは**ライブダッシュボードと同じUI**です — レンダラーを1つ共有しているため、2つが乖離することはありません: 検索・並び替え可能なルート一覧を持つマスター/ディテールレイアウト、重要度・カテゴリのフィルター、ダークモード、そして各指摘のコピー可能な AI Prompt が使えます。唯一の違いは、静的ファイルには背後に dev サーバーがないため、ライブ更新の仕組み(SSE接続、ブラウジングによる measured への精緻化)がないことです。CSS と JS をすべてインライン化しているためオフラインで動作し、CI 成果物として添付したり共有したりするのも簡単です。

Terminal window
svelte-vitals --reporter html                 # svelte-vitals-report.html を出力
svelte-vitals --reporter html --out-file report.html
svelte-vitals --reporter html --out-file -     # ファイルではなく標準出力へ

既定ではカレントディレクトリに svelte-vitals-report.html を書き出し、パスを stderr に表示します。--out-file <path> で出力先を変更でき、--out-file - で標準出力にストリームします（パイプや CI 成果物向け）。

自動選択の優先順位

Section titled “自動選択の優先順位”
  1. 明示的な --reporter <fmt> — 常に最優先。
  2. SVELTE_VITALS_REPORTER 環境変数 — 自動検出を上書き。
  3. AI エージェント環境（例：CLAUDECODE が設定されている）→ agent。
  4. GitHub Actions（GITHUB_ACTIONS=true）→ github。
  5. デフォルト → console。

例：CI パイプライン

Section titled “例：CI パイプライン”
.github/workflows/seo.yml
- name: Check SEO
  run: npx svelte-vitals@latest --fail-on warning
  # GITHUB_ACTIONS はすでに設定済み；github レポーターが自動選択される