chrome.userScripts

説明

userScripts API を使用して、ユーザー スクリプトのコンテキストでユーザー スクリプトを実行します。

権限

userScripts

User Scripts API chrome.userScripts を使用するには、manifest.json に "userScripts" 権限を追加し、スクリプトを実行するサイトの "host_permissions" を追加します。

{
  "name": "User script test extension",
  "manifest_version": 3,
  "minimum_chrome_version": "120",
  "permissions": [
    "userScripts"
  ],
  "host_permissions": [
    "*://example.com/*"
  ]
}

対象

Chrome 120 以降 MV3 以降

コンセプトと使用方法

ユーザー スクリプトは、ウェブページの外観や動作を変更するためにウェブページに挿入されるコード スニペットです。Content Scripts や chrome.scripting API などの他の拡張機能とは異なり、User Scripts API では任意のコードを実行できます。この API は、拡張機能パッケージの一部として出荷できないユーザー提供のスクリプトを実行する拡張機能に必要です。

拡張機能ユーザー向けのデベロッパー モード

拡張機能のデベロッパーは、インストールした Chrome でデベロッパー モードをすでに有効にしています。ユーザー スクリプト拡張機能の場合は、ユーザーがデベロッパー モードを有効にする必要もあります。以下に、ご自身のドキュメントにコピーして貼り付けることができる手順を示します。

  1. 新しいタブで chrome://extensions と入力して、[拡張機能] ページに移動します。（設計上、chrome:// URL はリンクできません）。

  2. [デベロッパー モード] の横にある切り替えスイッチをクリックして、デベロッパー モードを有効にします。