UserScripts.UserScriptOptions (舊版)

警告:這是已棄用的 userScripts API 的文件。它在 Manifest V2 的 Firefox 中可用。有關在 Manifest V3 中支援使用者指令碼的功能,請參閱新的 userScripts API。

UserScriptOptions 物件代表要註冊的內容指令碼。它具有與 browser.contentScripts.register 支援的 contentScript 選項類似的語法。區別在於:

  • 它不支援 CSS 屬性(請使用 browser.contentScripts.register 動態註冊/登出樣式表)
  • 它支援一個可選的 scriptMetadata 屬性(作為一個純 JSON 物件,其中包含與註冊的 userScripts 相關的一些元資料屬性)

UserScriptOptions 物件具有以下屬性:

allFrames 可選

content_scripts 鍵中的 all_frames 相同。

excludeGlobs 可選

content_scripts 鍵中的 exclude_globs 相同。

excludeMatches 可選

content_scripts 鍵中的 exclude_matches 相同。

includeGlobs 可選

content_scripts 鍵中的 include_globs 相同。

js 可選

一個物件陣列。每個物件都有一個名為 file 的屬性(該屬性是一個從擴充套件的 manifest.json 開始的 URL,指向要註冊的 JavaScript 檔案),或者一個名為 code 的屬性(該屬性是要註冊的一些 JavaScript 程式碼)。

matchAboutBlank 可選

content_scripts 鍵中的 match_about_blank 相同。

matches

content_scripts 鍵中的 matches 相同。

runAt 可選

content_scripts 鍵中的 run_at 相同。

scriptMetadata 可選

使用者指令碼元資料值。

它具有與 browser.contentScripts.register 支援的 contentScript 選項類似的語法。