Chrome Extension Dev

ブラウザ拡張機能開発の包括的ガイド。

When to Use

• ブラウザ拡張機能を作りたい、Chrome拡張、browser extension
• WXT フレームワークでの開発
• Content Script / Service Worker の実装
• Chrome API（tabs, storage, cookies等）の使用
• Manifest V3 への対応・移行

推奨技術スタック（2025/2026）

WXT クイックスタート

# 新規プロジェクト作成
npm create wxt@latest

# テンプレート指定
npm create wxt@latest -- --template react-ts
npm create wxt@latest -- --template vue-ts

# 開発コマンド
npm run dev    # HMR付き開発サーバー
npm run build  # プロダクションビルド
npm run zip    # ストア提出用パッケージ

プロジェクト構成

project/
├── entrypoints/           # 自動検出エントリポイント
│   ├── background.ts      # Service Worker
│   ├── content.ts         # Content Script
│   ├── popup/             # Popup UI
│   │   ├── index.html
│   │   └── main.tsx
│   └── options/           # Options Page
├── components/            # 自動インポートUIコンポーネント
├── utils/                 # 自動インポートユーティリティ
├── public/                # 静的アセット（icon等）
├── wxt.config.ts          # WXT設定
└── package.json

主要 Chrome API

→ 詳細: references/chrome-api.md

Manifest V3 制限事項

→ 詳細: references/manifest-v3.md

権限変更時の注意

⚠️ 重要: permissions/host_permissions変更後は拡張機能の再読み込みでは不十分。 削除→再インストールが必要。

Key References

Done Criteria

• WXT プロジェクト構成が正しい
• 必要な権限が wxt.config.ts に設定されている
• Manifest V3 制限を考慮した実装
• 開発モードで動作確認済み
• ビルドエラーがない

External Resources

• WXT 公式
• Chrome Extension Docs
• Chrome API Reference