歡迎使用擴充功能!
YouTube 擴充功能
Chrome 線上應用程式商店幕後:向產品經理提問
什麼是內容指令碼?
什麼是遠端代管程式碼?
擴充功能運作情形
Action API 示範
UserScript API 示範
Scripting API 示範
SidePanel API 示範
擴充功能貼文
chrome.contentSettings
使用 chrome.contentSettings API 變更設定,控制網站是否可使用 Cookie、JavaScript 和外掛程式等功能。一般來說,內容設定可讓你針對個別網站自訂 Chrome 的行為,而非全域設定。 您必須在擴充功能的資訊清單中宣告「contentSettings」權限,才能使用 API。例如: 您可以使用模式指定每個內容設定會影響哪些網站。例如, https://*.youtube.com/* 會指定 youtube.com 及其所有子網域。內容設定模式的語法與
chrome.printing
使用 chrome.printing API 將列印工作傳送至 Chromebook 上安裝的印表機。 所有 chrome.printing 方法和事件都需要您在 擴充功能資訊清單 中宣告 "printing" 權限。例如: 以下範例示範如何使用列印命名空間中的每個方法。這個程式碼是從 extensions-samples GitHub 存放區的 api-samples/printing 複製而來,或以該程式碼為基礎。 在本範例中,當 jobStatus 不是 PENDING 或
chrome.userScripts
使用 userScripts API 在「User Scripts」情境中執行使用者指令碼。 如要使用 User Scripts API ( chrome.userScripts ),請在 manifest.json 中加入 "userScripts" 權限,並為要執行指令碼的網站加入 "host_permissions" 。 使用者指令碼是插入網頁的程式碼片段,可用來修改網頁的外觀或行為。與其他擴充功能 (例如 內容指令碼 和 chrome.scripting API ) 不同,使用者指令碼
chrome.sessions
使用 chrome.sessions API 查詢及還原瀏覽工作階段中的分頁和視窗。 字串 外部裝置的名稱。 工作階段 [] 外部裝置的已開啟視窗工作階段清單,依最近修改的工作階段排序。 號碼 選填 在要求清單中擷取的項目數量上限。如要擷取項目的數量上限,請省略這個參數 ( sessions.MAX_SESSION_RESULTS )。 數字 視窗或分頁關閉或修改的時間,以世界標準時間指定期間開始計算,以秒為單位。 分頁 選填 如果這個項目描述分頁,則為 tabs.Tab 。系統會設定這個值或
chrome.printing
使用 chrome.printing API 將列印工作傳送至 Chromebook 上安裝的印表機。 所有 chrome.printing 方法和事件都需要您在 擴充功能資訊清單 中宣告 "printing" 權限。例如: 以下範例示範如何使用列印命名空間中的每個方法。這個程式碼是從 extensions-samples GitHub 存放區的 api-samples/printing 複製而來,或以該程式碼為基礎。 在本範例中,當 jobStatus 不是 PENDING 或
chrome.sessions
使用 chrome.sessions API 查詢及還原瀏覽工作階段中的分頁和視窗。 字串 外部裝置的名稱。 工作階段 [] 外部裝置的已開啟視窗工作階段清單,依最近修改的工作階段排序。 號碼 選填 在要求清單中擷取的項目數量上限。如要擷取項目的數量上限,請省略這個參數 ( sessions.MAX_SESSION_RESULTS )。 數字 視窗或分頁關閉或修改的時間,以世界標準時間指定期間開始計算,以秒為單位。 分頁 選填 如果這個項目描述分頁,則為 tabs.Tab 。系統會設定這個值或
chrome.contentSettings
使用 chrome.contentSettings API 變更設定,控制網站是否可使用 Cookie、JavaScript 和外掛程式等功能。一般來說,內容設定可讓你針對個別網站自訂 Chrome 的行為,而非全域設定。 您必須在擴充功能的資訊清單中宣告 "contentSettings" 權限,才能使用 API。例如: 您可以使用模式指定每個內容設定的適用網站。例如, https://*.youtube.com/* 會指定 youtube.com 及其所有子網域。內容設定模式的語法與
chrome.i18n
使用 chrome.i18n 基礎架構,在整個應用程式或擴充功能中實作國際化。 如果擴充功能有 /_locales 目錄, manifest 就必須定義 "default_locale" 。 您必須將所有向使用者顯示的字串放入名為 messages.json 的檔案中。每次新增語言代碼時,請在名為 /_locales/_localeCode_ 的目錄下新增訊息檔案,其中 localeCode 是英文的 en 等代碼。 以下是支援英文 ( en )、西班牙文 ( es ) 和韓文 ( ko )
chrome.storage
使用 chrome.storage API 儲存、擷取及追蹤使用者資料的變更。 如要使用儲存空間 API,請在擴充功能的 manifest 中宣告 "storage" 權限。例如: Storage API 提供擴充功能專屬方式,可保留使用者資料和狀態。這個 API 與網路平台的儲存空間 API ( IndexedDB 和 Storage ) 類似,但設計目的是滿足擴充功能的儲存空間需求。以下列舉幾個主要功能: 雖然擴充功能可以在某些情況 (彈出式視窗和其他 HTML 頁面) 下使用
chrome.storage
使用 chrome.storage API 儲存、擷取及追蹤使用者資料的變更。 Storage API 提供擴充功能專屬方式,可保留使用者資料和狀態。這個 API 與網路平台的儲存空間 API ( IndexedDB 和 Storage ) 類似,但設計目的是滿足擴充功能的儲存空間需求。以下列舉幾個主要功能: 雖然擴充功能可以在某些情況 (彈出式視窗和其他 HTML 頁面) 下使用 [ Storage ][mdn-storage] 介面 (可透過 window.localStorage
擴充功能 / 開始使用
開始使用 Chrome 擴充功能的所有基本知識
chrome.enterprise.platformKeys
使用 chrome.enterprise.platformKeys API 產生金鑰,並為這些金鑰安裝憑證。憑證會由平台管理,可用於 TLS 驗證、網路存取,或透過 chrome.platformKeys 由其他擴充功能使用。 使用這個 API 註冊用戶端憑證的一般步驟如下: 使用 enterprise.platformKeys.getTokens 取得所有可用的符記。 找出 id 等於 "user" 的符記。之後請使用這個權杖。 使用 generateKey 權杖方法 (在
chrome.enterprise.platformKeys
使用 chrome.enterprise.platformKeys API 產生金鑰,並為這些金鑰安裝憑證。憑證會由平台管理,可用於 TLS 驗證、網路存取,或透過 chrome.platformKeys 由其他擴充功能使用。 使用這個 API 註冊用戶端憑證的一般步驟如下: 使用 enterprise.platformKeys.getTokens() 取得所有可用的符記。 找出 id 等於 "user" 的權杖。之後請使用這個權杖。 使用 generateKey() 權杖方法 (在
chrome.permissions
請使用 chrome.permissions API,在執行階段 (而非安裝階段) 要求 已宣告的選用權限 ,讓使用者瞭解為何需要這些權限,並只授予必要的權限。 權限警告會說明 API 授予的功能,但部分警告可能不明顯。Permissions API 可讓開發人員說明權限警告,並逐步推出新功能,讓使用者無須擔心風險,就能瞭解擴充功能。如此一來,使用者就能指定願意授予的存取權,以及要啟用的功能。 舉例來說, 選用權限擴充功能
chrome.runtime
使用 chrome.runtime API 擷取服務工作者、傳回資訊清單的詳細資料,並監聽擴充功能生命週期中的事件並做出回應。您也可以使用這個 API,將網址的相對路徑轉換為完整網址。 Runtime API 提供方法,可支援擴充功能可使用的多個功能領域: 執行階段 API 中的大多數方法 不 需要任何權限,但需要 nativeMessaging 權限的 sendNativeMessage 和 connectNative 例外。 以下範例說明如何在資訊清單中宣告 nativeMessaging
chrome.permissions
請使用 chrome.permissions API,在執行階段 (而非安裝階段) 要求 已宣告的選用權限 ,讓使用者瞭解為何需要這些權限,並只授予必要的權限。 權限警告會說明 API 授予的功能,但部分警告可能不明顯。Permissions API 可讓開發人員說明權限警告,並逐步推出新功能,讓使用者無須擔心風險,就能瞭解擴充功能。如此一來,使用者就能指定願意授予的存取權,以及要啟用的功能。 舉例來說, 選用權限擴充功能
2025 年 1 月 Chrome 擴充功能的最新消息
概略說明 Chrome 擴充功能的最新變更,以及開發人員可以期待的未來擴充功能。
chrome.bookmarks
使用 chrome.bookmarks API 建立、整理及操作書籤。另請參閱「 覆寫頁面 」,您可以使用這項功能建立自訂的「書籤管理員」頁面。 您必須在 擴充功能資訊清單 中宣告「書籤」權限,才能使用書籤 API。例如: 書籤會以樹狀結構排列,其中每個節點都是書籤或資料夾 (有時稱為「群組」 )。樹狀結構中的每個節點都會由 bookmarks.BookmarkTreeNode 物件表示。 BookmarkTreeNode 屬性會用於整個 chrome.bookmarks
chrome.bookmarks
這項權限會 觸發警告 。 使用 chrome.bookmarks API 建立、整理及操作書籤。另請參閱「 覆寫頁面 」,您可以使用這項功能建立自訂的「書籤管理員」頁面。 您必須在 擴充功能資訊清單 中宣告「書籤」權限,才能使用書籤 API。例如: 書籤會以樹狀結構排列,其中每個節點都是書籤或資料夾 (有時稱為「群組」 )。樹狀結構中的每個節點都會由 bookmarks.BookmarkTreeNode 物件表示。 BookmarkTreeNode 屬性會用於整個
Chrome 線上應用程式商店政策更新:確保開發人員能清楚瞭解政策內容並保持一致
Chrome 線上應用程式商店致力於為開發人員和使用者打造優質可靠的生態系統。為達成這個目標,我們宣布一系列政策更新,旨在讓平台上的政策更明確一致。這些更新涵蓋功能、內容標準和開發人員指南等重要領域。 我們正在簡化 申訴程序 ,讓申訴流程更有效率且更公開透明。日後,開發人員將可針對每項政策違規提出一次申訴。判決結果一旦確定,開發人員就無法重新提出申訴。 為配合更廣泛的 Google 產品政策,我們會更新 用詞 ,明確禁止在 Chrome
chrome.tabs
使用 chrome.tabs API 與瀏覽器的分頁系統互動。您可以使用這個 API 在瀏覽器中建立、修改及重新排列分頁。 Tabs API 不僅提供操作和管理分頁的功能,還可偵測分頁的 語言 、拍攝 螢幕截圖 ,以及與分頁的內容指令碼 通訊 。 大多數功能都不需要任何權限即可使用。例如: 建立 新分頁、 重新載入 分頁、 前往 其他網址等。 開發人員在使用 Tabs API 時,應注意三項權限。 這個權限不會授予 chrome.tabs 命名空間的存取權。相反地,它會授予擴充功能在
chrome.tabs
使用 chrome.tabs API 與瀏覽器的分頁系統互動。您可以使用這個 API 在瀏覽器中建立、修改及重新排列分頁。 Tabs API 不僅提供操作和管理分頁的功能,還可偵測分頁的 語言 、拍攝 螢幕截圖 ,以及與分頁的內容指令碼 通訊 。 大多數功能都不需要任何權限即可使用。例如: 建立 新分頁、 重新載入 分頁、 前往 其他網址等。 開發人員在使用 Tabs API 時,應注意三項權限。 以下範例說明如何在 manifest 中宣告每項權限: 以下各節將說明一些常見用途。
chrome.ttsEngine
使用 chrome.ttsEngine API 實作文字轉語音(TTS) 引擎,並使用擴充功能。如果擴充功能是使用這個 API 註冊,當任何擴充功能或 Chrome 應用程式使用 tts API 產生語音時,擴充功能就會收到包含要朗讀的字詞和其他參數的事件。擴充功能接著可以使用任何可用的網路技術來合成及輸出語音,並將事件傳回呼叫函式以回報狀態。 擴充功能可以註冊為語音引擎。這樣一來,它就能攔截對 tts.speak 和 tts.stop
chrome.cookies
使用 chrome.cookies API 查詢及修改 Cookie,並在 Cookie 變更時收到通知。 如要使用 cookies API,您必須在資訊清單中宣告「cookies」權限,以及您要存取 cookies 的任何主機的 主機權限 。例如: 分區 Cookie 可讓網站標示特定 Cookie 應以頂層框架的來源做為索引。也就是說,如果網站 A 使用 iframe 嵌入網站 B 和網站 C,則分割 Cookie 在各網站中的值可能不同。 chrome.cookies
chrome.cookies
使用 chrome.cookies API 查詢及修改 Cookie,並在 Cookie 變更時收到通知。 如要使用 cookies API,請在資訊清單中宣告 "cookies" 權限,以及您要存取 cookie 的任何主機的 主機權限 。例如: 分區 Cookie 可讓網站標示特定 Cookie 應根據頂層框架的來源進行編碼。舉例來說,如果網站 A 使用 iframe 在網站 B 和網站 C 中嵌入,來自 A 的已分割 Cookie 的嵌入版本,在 B 和 C 中可能會有不同的值。
chrome.ttsEngine
使用 chrome.ttsEngine API 實作文字轉語音(TTS) 引擎,並使用擴充功能。如果擴充功能是使用這個 API 註冊,當任何擴充功能或 Chrome 應用程式使用 tts API 產生語音時,擴充功能就會收到包含要朗讀的字詞和其他參數的事件。擴充功能接著可以使用任何可用的網路技術來合成及輸出語音,並將事件傳回呼叫函式以回報狀態。 擴充功能可以註冊為語音引擎。這樣一來,它就能攔截對 tts.speak() 和 tts.stop()
Chrome 擴充功能的新功能's
Chrome 擴充功能平台、說明文件和政策近期異動
chrome.certificateProvider
使用這個 API 將憑證公開給平台,讓平台可用這些憑證進行 TLS 驗證。 這個 API 的典型用途是將用戶端憑證公開給 ChromeOS,步驟如下: 實際步驟順序可能不同。舉例來說,如果使用自動選取憑證的企業政策,系統就不會要求使用者選取憑證 (請參閱「 AutoSelectCertificateForUrls 」和「 適用於使用者的 Chrome 政策 」)。 在擴充功能中,這可能會類似於以下程式碼片段: 系統支援的加密編譯簽章演算法類型。
chrome.extension
chrome.extension API 提供可供任何擴充功能頁面使用的公用程式。這項功能可支援在擴充功能與其內容指令碼之間,或在擴充功能之間交換訊息,詳情請參閱「 訊息傳遞 」一文。 擴充功能檢視畫面的類型。 "tab" "popup" 對於在無痕分頁中執行的內容指令碼,以及在無痕處理程序中執行的擴充功能頁面,此值為 True。後者僅適用於使用「split」incognito_behavior 的擴充功能。 布林值 針對目前擴充功能中執行的背景頁面,傳回 JavaScript
chrome.system.display
使用 system.display API 查詢顯示中繼資料。 列舉值,用於指出系統是否偵測到並使用螢幕。如果系統未偵測到螢幕 (可能已中斷連線,或因睡眠模式而被視為中斷連線),則系統會將螢幕視為「非活動」狀態。例如,當所有螢幕都已中斷連線時,系統會使用此狀態保留現有螢幕。 "active" 「inactive」 數字 螢幕高度 (以像素為單位)。 數字 左上角的 X 座標。 數字 左上角的 y 座標。 數字 螢幕寬度 (以像素為單位)。 字串 螢幕的專屬 ID。 數字
chrome.system.display
使用 system.display API 查詢顯示中繼資料。 列舉值,用於指出系統是否偵測到並使用螢幕。如果系統未偵測到螢幕 (可能已中斷連線,或因睡眠模式而被視為中斷連線),則系統會將螢幕視為「非活動」狀態。例如,當所有螢幕都已中斷連線時,系統會使用此狀態保留現有螢幕。 "active" 「inactive」 數字 螢幕高度 (以像素為單位)。 數字 左上角的 X 座標。 數字 左上角的 y 座標。 數字 螢幕寬度 (以像素為單位)。 字串 螢幕的專屬 ID。 數字
chrome.action
使用 chrome.action API 控制 Google Chrome 工具列中的擴充功能圖示。 如要使用這個 API,您必須 在資訊清單中宣告下列鍵 。 如要使用 chrome.action API,請指定 "manifest_version" 為 3 ,並在 資訊清單檔案 中加入 "action" 鍵。 "action" 鍵 (以及子鍵) 為選用項目。如果未納入,工具列仍會顯示擴充功能,以便使用者存取擴充功能的選單。因此,建議您一律納入至少 "action" 和
chrome.commands
使用指令 API 新增鍵盤快速鍵,以便在擴充功能中觸發動作,例如開啟瀏覽器動作或向擴充功能傳送指令。 如要使用這個 API,您必須 在資訊清單中宣告下列鍵 。 Commands API 可讓擴充功能開發人員定義特定指令,並將指令繫結至預設的按鍵組合。擴充功能接受的每個指令,都必須在 擴充功能資訊清單 中宣告為 "commands" 物件的屬性。 屬性鍵會用做指令名稱。指令物件可採用兩種屬性。 這是個選屬性,用於宣告指令的預設鍵盤快速鍵。如果省略,則指令將不會綁定。這個屬性可接受字串或物件值。
chrome.certificateProvider
使用這個 API 將憑證公開給平台,讓平台可用這些憑證進行 TLS 驗證。 這個 API 的典型用途是將用戶端憑證公開給 ChromeOS,步驟如下: 實際步驟順序可能不同。舉例來說,如果使用自動選取憑證的企業政策,系統就不會要求使用者選取憑證 (請參閱 AutoSelectCertificateForUrls 和「 使用者適用的 Chrome 政策 」)。 在擴充功能中,這可能會類似於以下程式碼片段: 系統支援的加密編譯簽章演算法類型。 "RSASSA_PKCS1_v1_5_MD5_SHA1"
chrome.extension
chrome.extension API 提供可供任何擴充功能頁面使用的公用程式。這項功能可支援在擴充功能與其內容指令碼之間,或在擴充功能之間交換訊息,詳情請參閱「 訊息傳遞 」一文。 擴充功能檢視畫面的類型。 "tab" "popup" 對於在無痕分頁中執行的內容指令碼,以及在無痕處理程序中執行的擴充功能頁面,此值為 True。後者僅適用於使用「split」incognito_behavior 的擴充功能。 布林值 請使用 runtime.lastError 。 如果非同步擴充功能 API
chrome.fontSettings
使用 chrome.fontSettings API 管理 Chrome 的字型設定。 如要使用 Font Settings API,您必須在 擴充功能資訊清單 中宣告 "fontSettings" 權限。例如: Chrome 允許部分字型設定取決於特定的通用字型系列和語言腳本。舉例來說,Sans Serif 簡體中文使用的字型,可能與 Serif 日文使用的字型不同。 Chrome 支援的通用字型系列是以 CSS 通用字型系列 為基礎,並列於 GenericReference
擴充功能和 AI
瞭解如何運用 AI 開發擴充功能
chrome.documentScan
使用 chrome.documentScan API 探索及擷取附加的文件掃描器中的圖片。
chrome.declarativeContent
使用 chrome.declarativeContent API 可根據網頁內容採取行動,且無須取得讀取網頁內容的權限。 宣告式內容 API 可讓您根據網頁的網址或 CSS 選取器是否與網頁上的元素相符,啟用擴充功能的動作,而無需新增 主機權限 或插入 內容指令碼 。 使用 activeTab 權限,在使用者點選擴充功能動作後與網頁互動。 規則包含條件和動作。如果任何條件成立,系統就會執行所有動作。動作為 setIcon() 和 showAction() 。 只有在符合所有列出條件時,
chrome.desktopCapture
桌面擷取 API 可擷取螢幕畫面、個別視窗或個別分頁的內容。 用於定義在 chooseDesktopMedia() 中使用的電腦媒體來源集合的列舉。 "screen" "window" "tab" "audio" 鏡像 SelfCapturePreferenceEnum 。 「include」 "exclude" 與 SystemAudioPreferenceEnum 互通。 「include」 "exclude" 隱藏由 chooseDesktopMedia() 顯示的桌面媒體選擇器對話方塊。
chrome.dns
使用 chrome.dns API 進行 DNS 解析。 如要使用這個 API,您必須在 manifest 中宣告 "dns" 權限。 以下程式碼會呼叫 resolve() ,擷取 example.com 的 IP 位址。 service-worker.js: string 選填 代表 IP 位址常值的字串。只有在 resultCode 表示成功時才會提供。 數字 結果代碼。零表示成功。 解析指定的主機名稱或 IP 位址文字。 字串 要解析的主機名稱。 函式 選填 callback
chrome.system.storage
使用 chrome.system.storage API 查詢儲存裝置資訊,並在可移除儲存裝置連接和解除連接時收到通知。 "success" 彈出指令成功執行,應用程式可提示使用者移除裝置。 "in_use" 裝置正在由其他應用程式使用。彈出裝置失敗;使用者應等待其他應用程式完成使用裝置後,再移除裝置。 "no_such_device" 系統未知曉有此裝置。 "failure" 彈出指令失敗。 數字 儲存裝置的可用容量,以位元組為單位。 字串 getAvailableCapacity 函式參數
chrome.contextMenus
使用 chrome.contextMenus API 將項目新增至 Google Chrome 的內容功能表。您可以選擇內容選單新增項目適用於哪些類型的物件,例如圖片、超連結和頁面。 您必須在擴充功能的資訊清單中宣告 "contextMenus" 權限,才能使用 API。此外,您應指定 16 x 16 像素的圖示,以便顯示在選單項目旁邊。例如: 內容功能表項目可顯示在任何文件 (或文件內的框架) 中,甚至是含有 file:// 或 chrome://
chrome.alarms
使用 chrome.alarms API 排定程式碼,以便定期執行或在未來的特定時間執行。 如要使用 chrome.alarms API,請在 manifest 中宣告 "alarms" 權限: 為確保可靠的行為,建議您瞭解 API 的運作方式。 裝置在休眠狀態時,鬧鐘會繼續運作。不過,鬧鐘不會喚醒裝置。裝置喚醒時,系統會觸發所有未響起的鬧鐘。重複鬧鐘最多會觸發一次,然後會從裝置喚醒開始,以指定的時間間隔重新排定鬧鐘,但不會考量鬧鐘原本設定的執行時間已過的時間。
chrome.audio
chrome.audio API 可讓使用者取得系統連結的音訊裝置相關資訊,並控制這些裝置。這個 API 目前僅適用於 ChromeOS 的資訊站模式。 字串 裝置名稱。 DeviceType 裝置的類型。 字串 使用者容易閱讀的名稱 (例如「USB 麥克風」)。 字串 音訊裝置的專屬 ID。 布林值 如果是目前的活動裝置,則為「是」。 數字 裝置的音量、輸出音量、輸入增益。 string 選填 穩定/永久裝置 ID 字串 (如有)。 StreamType 與此裝置相關聯的串流類型。
chrome.declarativeNetRequest
chrome.declarativeNetRequest API 可用於指定宣告式規則,藉此封鎖或修改網路要求。這樣一來,擴充功能就能修改網路要求,而不必攔截並查看內容,進而提供更完善的隱私權保護。 「 declarativeNetRequest 」和「 declarativeNetRequestWithHostAccess 」權限提供相同的功能。兩者之間的差異在於權限要求或授予的時間。 除了先前所述的權限之外,某些類型的規則集 (特別是靜態規則集) 需要宣告
chrome.devtools.panels
使用 chrome.devtools.panels API 將擴充功能整合至「開發人員工具」視窗使用者介面:建立您自己的面板、存取現有的面板,以及新增側欄。 每個擴充功能面板和側欄都會顯示為獨立的 HTML 頁面。在「開發人員工具」視窗中顯示的所有擴充功能頁面,皆可存取 chrome.devtools API 的所有部分,以及所有其他擴充功能 API。 您可以使用 devtools.panels.setOpenResourceHandler 方法安裝回呼函式,以便處理使用者開啟資源的請求
chrome.fileBrowserHandler
使用 chrome.fileBrowserHandler API 擴充 ChromeOS 檔案瀏覽器。舉例來說,您可以使用這個 API 讓使用者將檔案上傳至網站。 使用者按下 Alt + Shift + M 或連接外部儲存裝置 (例如 SD 卡、USB 隨身碟、外接硬碟或數位相機) 時,ChromeOS 檔案瀏覽器就會顯示。除了顯示外部裝置上的檔案,檔案瀏覽器還能顯示使用者先前儲存至系統的檔案。
chrome.readingList
使用 chrome.readingList API 讀取及修改 閱讀清單 中的項目。 如要使用 Reading List API,請在擴充功能 資訊清單 檔案中加入 "readingList" 權限: manifest.json: Chrome 會在側邊面板顯示閱讀清單。使用者可儲存網頁,以便稍後或離線時閱讀。 使用 Reading List API 擷取現有項目,並在清單中新增或移除項目。 閱讀清單中的項目並非絕對順序。 各項目均有索引鍵網址。其中包括雜湊和查詢字串。 以下各節說明一些
API 參考資料
Chrome 擴充功能所提供所有 API 的完整參考資料。包括已淘汰的 Chrome 應用程式平台的 API,以及仍處於 Beta 版和開發階段的 API。
2024 年 10 月 Chrome 擴充功能的最新消息
概略說明 Chrome 擴充功能的最新變更,以及開發人員可以期待的未來擴充功能。
改善 Chrome 線上應用程式商店開發人員資訊主頁的行動裝置體驗
我們很高興推出一組 UI 變更,讓 Chrome 線上應用程式商店開發人員資訊主頁更有回應性,也更適合在行動裝置上使用。我們希望這項功能能讓您在監控商店資訊成效、修改商店資訊,以及管理商店擴充功能時,享有更便利的體驗。 我們已更新所有圖表和分析頁面,讓這些頁面更有彈性,方便你查看擴充功能在行動裝置上的商店資訊成效。 你也可以透過行動裝置更新商店中繼資料,包括說明、圖片和隱私權設定。
chrome.tabGroups
使用 chrome.tabGroups API 與瀏覽器的分頁分組系統互動。你可以使用這個 API 修改及重新排列瀏覽器的分頁群組。如要將分頁分組或取消分組,或是查詢群組中的分頁,請使用 chrome.tabs API。 群組的顏色。 "灰色" "blue" "紅色" "黃色" "green" 「粉紅色」 "紫色" "青色" 「橘色」 布林值 群組是否收合。收合的群組就是其分頁隱藏的群組。 顏色 群組的顏色。 數字 群組 ID。單一瀏覽器工作階段內的群組 ID 不得重複。 string
chrome.privacy
在 Chrome 中,您可以使用 chrome.privacy API 控制哪些功能會影響使用者隱私。這個 API 需要運用 ChromeSetting 類型 API 原型 取得及設定 Chrome 的設定。 您必須聲明「隱私權」擴充功能 資訊清單 中具有使用 API 的權限。例如: 現在可以直接讀取 Chrome 設定目前的值。首先,您需要找出 請針對該物件呼叫 get() ,以便擷取 目前價值和擴充功能的控制層級舉例來說,用於判斷 Chrome 的信用卡資訊是否自動填入 此時應寫入:
chrome.wallpaper
使用 chrome.wallpaper API 變更 ChromeOS 桌布。 您必須聲明「桌布」應用程式 資訊清單 中要使用的權限 桌布 API例如: 例如,如要將桌布設為 https://example.com/a_file.png ,你可以呼叫 chrome.wallpaper.setWallpaper : 支援的桌布版面配置。 "STRETCH" "CENTER" "CENTER_CROPPED" 將桌布設為 url 或 wallpaperData 搭配指定的 layout 物件
chrome.system.storage
使用 chrome.system.storage API 查詢儲存裝置資訊,並在連接及卸離卸除式儲存裝置時收到通知。 "success" 排除指令成功,應用程式可提示使用者移除裝置。 "in_use" 已有其他應用程式正在使用這部裝置。排除失敗;在使用者使用裝置完成前,請勿移除裝置。 "no_such_device" 我找不到這類裝置。 "failure" 排除指令失敗。 數字 儲存裝置的可用容量,以位元組為單位。 字串 getAvailableCapacity 函式參數 id 的複製 id 。
chrome.scripting
使用 chrome.scripting API 在不同的情況下執行指令碼。 如要使用 chrome.scripting API,請在 資訊清單 中宣告 "scripting" 權限,以及插入指令碼的網頁主機權限。使用 "host_permissions" 金鑰或 "activeTab" 權限,授予臨時主機權限。以下範例使用 Active Tab 權限。 您可以使用 chrome.scripting API 將 JavaScript 和 CSS 插入 網站。做法類似您可以撰寫的內容 指令碼
chrome.input.ime
使用 chrome.input.ime API 實作 Chrome OS 適用的自訂 IME。如此一來,你的擴充功能就能處理按鍵動作、設定組成及管理候選視窗。 您必須宣告「input」 擴充功能資訊清單 中的權限,以便使用 input.ime API。例如: 以下程式碼會建立輸入法編輯器,可將使用者輸入的字母轉換為大寫。 輔助視窗中的按鈕 ID。 "復原" "addToDictionary" 輔助視窗的屬性。 string optional ChromeVox 朗讀字串。 "復原" 布林值 設為
chrome.webAuthenticationProxy
chrome.webAuthenticationProxy API 可讓遠端主機上執行的遠端桌面軟體攔截 Web Authentication API (WebAuthn) 要求,以便在本機用戶端處理這些要求。 字串 傳遞至 navigator.credentials.create() 的 PublicKeyCredentialCreationOptions ,已序列化為 JSON 字串。序列化格式與
chrome.enterprise.hardwarePlatform
針對執行瀏覽器的硬體平台,您可以使用 chrome.enterprise.hardwarePlatform API 取得該硬體平台的製造商和型號。注意:這個 API 僅適用於由企業政策安裝的擴充功能。 字串 字串 取得硬體平台的製造商和型號;如果擴充功能經過授權,則會透過 callback 傳回。 函式 選用 callback 參數如下所示: HardwarePlatformInfo Promise< HardwarePlatformInfo > Promise
chrome.devtools.performance
使用 chrome.devtools.performance API,可監聽開發人員工具「效能」面板中的狀態更新記錄。 如要瞭解如何使用開發人員工具 API,請參閱「 開發人員工具 API 摘要 」一文。 chrome.devtools.performance API 可讓開發人員使用 Chrome 開發人員工具中 效能面板 面板的錄製功能。你可以使用這個 API 在錄製開始或停止時收到通知。 目前有兩個事件: 開發人員可藉由監聽這些事件,建立能回應「Performance」 (效能)
chrome.tabCapture
使用 chrome.tabCapture API 與分頁媒體串流互動。 chrome.tabCapture API 可讓您存取含有影片及內容的 MediaStream 目前分頁的音訊。只有在使用者叫用擴充功能後才能呼叫這個方法,例如: 按一下擴充功能的 動作按鈕 。這類似於 "activeTab" 權限。 為分頁取得 MediaStream 後,系統就會停止播放該分頁中的音訊 以便傳達給使用者這與在發生下列情況時, getDisplayMedia() 函式的行為類似
chrome.vpnProvider
使用 chrome.vpnProvider API 實作 VPN 用戶端。 chrome.vpnProvider 的一般使用如下: 呼叫 createConfig() 來建立 VPN 設定。VPN 設定是使用者在 ChromeOS UI 中看見的永久項目。使用者可以從清單中選取 VPN 設定,並與其連線或中斷連線。 將事件監聽器新增至 onPlatformMessage 、 onPacketReceived 和 onConfigRemoved 事件。 當使用者連線至 VPN 設定時,會收到
chrome.systemLog
使用 chrome.systemLog API 記錄擴充功能的 Chrome 系統記錄。 字串 這會新增記錄。 MessageOptions 記錄選項。 函式 選用 callback 參數如下所示: 承諾<void> Promise 適用於 Manifest V3 及以上版本,但系統會為 回溯相容性您無法在同一函式呼叫中同時使用兩者。 保證會以傳遞至回呼的相同類型來解析。
chrome.enterprise.deviceAttributes
使用 chrome.enterprise.deviceAttributes API 讀取裝置屬性。注意:這個 API 僅適用於由企業政策強制安裝的擴充功能。 擷取管理員加註的位置。如果目前的使用者未聯盟,或管理員未設定已加註的位置,則會傳回空字串。 函式 選用 callback 參數如下所示: 字串 承諾<字串> Promise 適用於 Manifest V3 及以上版本,但系統會為 回溯相容性您無法在同一函式呼叫中同時使用兩者。 保證會以傳遞至回呼的相同類型來解析。
chrome.power
使用 chrome.power API 覆寫系統的電源管理功能。 根據預設,作業系統會在使用者處於閒置狀態時調暗螢幕,最終將 有些人會將 Cloud Storage 視為檔案系統 但實際上不是只要使用 Power API,應用程式或擴充功能就能讓系統保持啟用狀態。 這個 API 可用於指定停用電源管理的 Level 。 "system" 水平儀,但允許螢幕變暗或關閉。舉例來說 即使螢幕關閉,通訊應用程式仍可繼續接收訊息。 "display"
chrome.system.memory
chrome.system.memory API。 數字 可用容量量,以位元組為單位。 數字 實體記憶體總容量 (以位元組為單位)。 取得實體記憶體資訊。 函式 選用 callback 參數如下所示: MemoryInfo Promise&lt; MemoryInfo &gt; Promise 適用於 Manifest V3 及以上版本,但系統會為 回溯相容性您無法在同一函式呼叫中同時使用兩者。 保證會以傳遞至回呼的相同類型來解析。
chrome.topSites
使用 chrome.topSites API 存取新分頁中顯示的熱門網站 (也就是最常造訪的網站)。但使用者自訂的捷徑不包括在內。 您必須宣告「top 網站」 擴充功能資訊清單 中的權限,才能使用這個 API。 如要試用這個 API,請安裝 chrome-extension-samples 提供的 top Sites API 範例 Cloud Storage 也提供目錄同步處理功能 這個物件會封裝最常造訪的網址,例如新分頁中的預設捷徑。 字串 頁面標題 字串 最常造訪的網址。 取得熱門網站清單。
chrome.proxy
使用 chrome.proxy API 管理 Chrome 的 Proxy 設定。這個 API 需要運用 ChromeSetting 類型 API 原型 取得及設定 Proxy 設定。 您必須宣告「proxy」請使用 擴充功能資訊清單 中的權限,才能使用 Proxy 設定 也能使用 Google Cloud CLI 或 Compute Engine API例如: Proxy 設定是在 proxy.ProxyConfig 物件中定義。視 Chrome 的 Proxy 設定而定 設定可能包含
chrome.enterprise.networkingAttributes
使用 chrome.enterprise.networkingAttributes API 讀取目前網路的相關資訊。注意:這個 API 僅適用於由企業政策強制安裝的擴充功能。 string optional 裝置的本機 IPv4 位址 (如未設定,則為未定義)。 string optional 裝置的本機 IPv6 位址 (如未設定,則為未定義)。 字串 裝置的 MAC 位址。 擷取裝置預設網路的網路詳細資料。如果使用者未隸屬於任何網域,或是裝置未連上網路,系統就會設定「
chrome.devtools.recorder
使用 chrome.devtools.recorder API 自訂開發人員工具中的「錄音工具」面板。 devtools.recorder API 是一項預先發布版功能,可讓您擴充 Chrome 開發人員工具中的 錄音工具面板 。 如要瞭解如何使用開發人員工具 API,請參閱「 開發人員工具 API 摘要 」一文。 如要註冊擴充功能外掛程式,請使用 registerRecorderExtensionPlugin 函式。這個函式需要外掛程式例項、 name 和 mediaType
chrome.system.cpu
使用 system.cpu API 查詢 CPU 中繼資料。 字串 處理器的架構名稱。 string[] 一組功能代碼,表示處理器功能。目前支援的代碼為「mmx」、「sse」、「sse2」、「sse3」、「ssse3」、「sse4_1」、「sse4_2」和「avx」。 字串 處理器的模型名稱。 數字 邏輯處理器數量。 ProcessorInfo [] 各個邏輯處理器的相關資訊。 數字 [] CPU 每個熱區的 CPU 溫度讀數清單。氣溫會以攝氏度為單位。 目前僅支援 ChromeOS。 數字
chrome.processes
使用 chrome.processes API 與瀏覽器的程序互動。 數字 使用的快取部分,以位元組為單位。 數字 快取的大小,以位元組為單位。 編號 選填 最新測量的處理程序 CPU 使用率,以程序所有執行緒總共使用單一 CPU 核心的百分比表示。這會將值從 0 變更為 CpuInfo.numOfProcessors*100,在多執行緒程序中,可能超過 100%。只有在從 onUpdated 或 onUpdatedWithMemory 的回呼中接收物件時,才會使用這個屬性。 快取 選用 程序的
chrome.devtools.network
使用 chrome.devtools.network API 可擷取開發人員工具在「網路」面板中顯示的網路要求相關資訊。 網路要求資訊會以 HTTP 封存格式 ( HAR ) 表示。裝置的說明 HAR 不在本文件的範圍內,請參閱 HAR v1.2 規格 。 就 HAR 而言, chrome.devtools.network.getHAR() 方法會傳回完整的 HAR 記錄 , chrome.devtools.network.onRequestFinished 事件提供 HAR 項目
chrome.webNavigation
使用 chrome.webNavigation API,即可接收關於傳輸中導航要求的狀態通知。 所有 chrome.webNavigation 方法和事件都必須宣告 "webNavigation" 權限 ,前往 擴充功能資訊清單 頁面。例如: 導覽成功時,事件會按下列順序觸發: 程序期間發生的任何錯誤都會導致 onErrorOccurred 事件。針對特定 導覽,在 onErrorOccurred 之後不再觸發其他事件。 如果導覽頁框含有子頁框,系統會先觸發其 onCommitted
chrome.search
使用 chrome.search API 透過預設提供者搜尋。 "CURRENT_TAB" 指定搜尋結果會顯示在使用中瀏覽器的分頁或分頁中。 "NEW_TAB" 指定搜尋結果會顯示在新分頁中。 "NEW_WINDOW" 指定搜尋結果會顯示在新視窗中。 處理方式 選用 要顯示搜尋結果的位置。預設值為 CURRENT_TAB 。 編號 選填 要顯示搜尋結果的位置。 tabId 無法與 disposition 搭配使用。 字串 要使用預設搜尋引擎查詢的字串。
chrome.devtools.inspectedWindow
使用 chrome.devtools.inspectedWindow API 與檢查的視窗互動:取得所檢查網頁的分頁 ID、評估所檢查視窗的程式碼、重新載入網頁,或是取得頁面中的資源清單。 如要瞭解如何使用開發人員工具 API,請參閱「 開發人員工具 API 摘要 」一文。 tabId 屬性會提供分頁 ID,您可以與 chrome.tabs.* 搭配使用 以及 API 呼叫但請注意, chrome.tabs.* API 不會向開發人員工具公開 基於安全性考量,擴充功能頁面—您必須將分頁 ID
chrome.tts
使用 chrome.tts API 播放合成的文字轉語音 (TTS)。另請參閱相關的 ttsEngine API,這個 API 可讓擴充功能實作語音引擎。 Chrome 可在 Windows (使用 SAPI 5)、Mac OS X 和 ChromeOS 上提供這項功能, 作業系統提供的語音合成功能在所有平台上,使用者可以 安裝本身註冊為替代語音引擎的擴充功能。 從擴充功能呼叫 speak() 即可說話。例如: 如要立即停止說話,只要呼叫 stop() 即可:
chrome.printerProvider
chrome.printerProvider API 會公開列印管理員使用的事件,用於查詢擴充功能控制的印表機、查詢其功能,以及向這些印表機提交列印工作。 string optional 印表機的人類可讀說明。 字串 印表機專屬 ID。 字串 印表機的人類可讀名稱。 為回應 onPrintRequested 事件而傳回的錯誤代碼。 "OK" 表示作業已成功完成。 "FAILED" 表示發生一般錯誤。 "INVALID_TICKET"
chrome.types
chrome.types API 包含 Chrome 的類型宣告。 ChromeSetting 類型提供一組常用函式 ( get() 、 set() 和 clear() ) Chrome 瀏覽器設定的事件發布者 ( onChange )。 Proxy 設定 。 Chrome 區分瀏覽器的設定有三種: Chrome 會管理不同層級的設定。以下清單說明可能的圖層 按優先順序遞增排序有效的設定 正如清單所指,政策可能會覆寫您透過擴充功能指定的任何變更。個人中心 可以使用 get()
chrome.printingMetrics
使用 chrome.printingMetrics API 擷取列印使用情形的相關資料。 "BLACK_AND_WHITE" 指出使用的是黑白模式。 "COLOR" 指定使用的是色彩模式。 "ONE_SIDED" 指定使用了單面列印。 &quot;TWO_SIDED_LONG_EDGE&quot; 指明使用了雙面列印,在長邊翻轉。 &quot;TWO_SIDED_SHORT_EDGE&quot; 指定使用了雙面列印,在短邊緣翻轉。 數字 用於列印的媒體高度
chrome.declarativeNetRequest
chrome.declarativeNetRequest API 可讓您指定宣告規則,藉此封鎖或修改網路要求。這可讓擴充功能在不攔截及查看網路要求的情況下,修改網路要求,進而加強隱私保護。 declarativeNetRequestFeedback host_permissions 除了上述權限以外,特定類型的規則集 (具體來說是靜態規則集) 需要宣告 "declarative_net_request" 資訊清單鍵,該鍵應使用名為 "rule_resources"
chrome.webRequest
使用 chrome.webRequest API 觀察及分析流量,以及攔截、封鎖或修改傳輸中的要求。 您必須在 擴充功能資訊清單 中宣告 "webRequest" 權限,才能使用網路要求 API,以及必要的 主機權限 。如要攔截子資源要求, 擴充功能必須同時具有要求網址及其發起者的存取權。例如: webRequestBlocking 必須授予這項權限,才能註冊封鎖事件處理常式。自 Manifest V3 起, 適用於政策已安裝的擴充功能 webRequestAuthProvider
chrome.sidePanel
使用 chrome.sidePanel API,在網頁主要內容與瀏覽器的側邊面板中代管內容。 如要使用 Side Panel API,請在擴充功能的 資訊清單 檔案中加入 "sidePanel" 權限: manifest.json: Side Panel API 可讓擴充功能在側邊面板中顯示自己的使用者介面,藉此提供持續強化使用者的瀏覽體驗。 部分功能包括: 以下各節說明 Side Panel API 的常見用途。如需完整的擴充功能範例,請參閱 擴充功能範例 。 您可以從資訊清單
chrome.pageAction
使用 chrome.pageAction API,將圖示放在 Google Chrome 主要工具列的右側。網頁動作代表可在目前網頁上進行,但不適用於所有網頁的動作。閒置時,網頁動作會顯示為灰色。 以下提供一些例子: 以下螢幕截圖中的 RSS 圖示代表網頁動作,可讓你訂閱 RSS 提供目前網頁的資訊提供。 隱藏的網頁動作會顯示為灰色。舉例來說,下方的 RSS 動態消息會顯示為灰色,因為你無法 訂閱目前網頁的資訊提供: 請考慮改用 瀏覽器動作 ,讓使用者能與您的 。 在 擴充功能資訊清單
chrome.omnibox
網址列 API 可讓您透過 Google Chrome 的網址列 (又稱為網址列) 註冊關鍵字。 使用者輸入擴充功能的關鍵字時,使用者只會開始與 。每個按鍵動作都會傳送至擴充功能,您可以提供回應建議。 這些建議可以使用多種格式。使用者接受建議後 您的擴充功能會收到通知,並可採取行動。 您必須在 資訊清單 中加入 omnibox keyword 欄位,才能使用網址列 API。個人中心 也應該指定 16x16 像素圖示;這個圖示會在您提供建議時顯示在網址列中 使用者會進入關鍵字模式 例如:
chrome.windows
使用 chrome.windows API 與瀏覽器視窗互動。您可以使用這個 API 在瀏覽器中建立、修改及重新排列視窗。 系統要求時, windows.Window 會包含 tabs.Tab 物件的陣列。您必須 如要存取 url ,請在 資訊清單 中宣告 "tabs" 權限。 tabs.Tab 的 pendingUrl 、 title 或 favIconUrl 屬性。例如: 擴充功能系統中的許多函式都會使用選用 windowId 引數,該引數預設為 。 「目前的視窗」
chrome.i18n
使用 chrome.i18n 基礎架構,為整個應用程式或擴充功能導入國際化功能。 您需要將所有使用者可看到的字串放入名為 messages.json 的檔案中。每次 新增語言代碼來新增訊息檔案,該目錄位於 _locales/_localeCode_ 目錄下,其中 localeCode 是一組代碼,例如 en 代表英文。 以下是支援英文 ( en ) 和西班牙文的國際化擴充功能檔案階層 ( es ) 和韓文 ( ko ): 假設您的擴充功能如下圖所示:
chrome.browserAction
使用瀏覽器動作將圖示放在 Google Chrome 主要工具列的網址列右側。除了其 圖示 以外,瀏覽器動作也可以提供 工具提示 、 徽章 和 彈出式視窗 。 在下圖中,網址列右側的彩色方塊是 瀏覽器動作。圖示下方會顯示彈出式視窗。 如果您想建立不一定會有效的圖示,請使用 網頁動作 ,而不要使用瀏覽器 動作。 在 擴充功能資訊清單 中註冊瀏覽器動作,如下所示: 你可以提供要用於 Chrome 的任何尺寸圖示,Chrome 會選擇最接近的尺寸和縮放比例 調整成適合的大小以填滿 16 dip
chrome.webRequest
使用 chrome.webRequest API 觀察及分析流量,以及攔截、封鎖或修改傳輸中的要求。 您必須在 擴充功能資訊清單 中宣告 "webRequest" 權限,才能使用網路要求 API,以及必要的 主機權限 。如要攔截子資源要求, 擴充功能必須同時具有要求網址及其發起者的存取權。例如: 自 Chrome 108 起,如果您使用 "webRequest" 和 "webRequestAuthProvider" ,即可透過非同步方式為 onAuthRequired 事件
chrome.fileBrowserHandler
使用 chrome.fileBrowserHandler API 擴充 Chrome OS 檔案瀏覽器。舉例來說,您可以透過這個 API 讓使用者上傳檔案到您的網站。 ChromeOS 檔案瀏覽器會在使用者按下 Alt + Shift + M 或連接外部儲存裝置 (例如 SD 卡、USB 金鑰、外接式磁碟或數位相機) 時啟動。除了在外部裝置上顯示檔案,檔案瀏覽器也可以顯示使用者先前儲存在系統中的檔案。
chrome.devtools.panels
使用 chrome.devtools.panels API 將擴充功能整合至開發人員工具視窗 UI:建立專屬面板、存取現有面板,以及新增側欄。 您必須在 資訊清單中 宣告下列金鑰,才能使用這個 API。 如要瞭解如何使用開發人員工具 API,請參閱「 開發人員工具 API 摘要 」一文。 每個擴充功能面板和側欄會顯示為個別的 HTML 網頁。已顯示所有擴充功能頁面 存取「開發人員工具」視窗中的所有模組,以及存取 chrome.devtools API 的所有模組,以及
chrome.system.cpu
使用 system.cpu API 查詢 CPU 中繼資料。 字串 處理器的架構名稱。 string[] 一組功能代碼,表示處理器功能。目前支援的代碼為「mmx」、「sse」、「sse2」、「sse3」、「ssse3」、「sse4_1」、「sse4_2」和「avx」。 字串 處理器的模型名稱。 數字 邏輯處理器數量。 ProcessorInfo [] 各個邏輯處理器的相關資訊。 數字 [] CPU 每個熱區的 CPU 溫度讀數清單。氣溫會以攝氏度為單位。 目前僅支援 ChromeOS。 數字
chrome.enterprise.networkingAttributes
使用 chrome.enterprise.networkingAttributes API 讀取目前網路的相關資訊。注意:這個 API 僅適用於由企業政策強制安裝的擴充功能。 string optional 裝置的本機 IPv4 位址 (如未設定,則為未定義)。 string optional 裝置的本機 IPv6 位址 (如未設定,則為未定義)。 字串 裝置的 MAC 位址。 擷取裝置預設網路的網路詳細資料。如果使用者未隸屬於任何網域,或是裝置未連上網路,系統就會設定「
chrome.loginState
使用 chrome.loginState API 讀取及監控登入狀態。 "SIGNIN_PROFILE" 指定擴充功能位於登入設定檔中。 "USER_PROFILE" 指定擴充功能位於使用者設定檔中。 "UNKNOWN" 表示工作階段狀態不明。 "IN_OOBE_SCREEN" 用於指定使用者處於開箱體驗的畫面。 "IN_LOGIN_SCREEN" 指定使用者位於登入畫面。 "IN_SESSION" 指定使用者正在進行工作階段。 "IN_LOCK_SCREEN" 指定使用者位於螢幕鎖定畫面。
chrome.input.ime
使用 chrome.input.ime API 實作 Chrome OS 適用的自訂 IME。如此一來,你的擴充功能就能處理按鍵動作、設定組成及管理候選視窗。 您必須宣告「input」 擴充功能資訊清單 中的權限,以便使用 input.ime API。例如: 以下程式碼會建立輸入法編輯器,可將使用者輸入的字母轉換為大寫。 輔助視窗中的按鈕 ID。 "復原" "addToDictionary" 輔助視窗的屬性。 string optional ChromeVox 朗讀字串。 "復原" 布林值 設為
chrome.fontSettings
使用 chrome.fontSettings API 管理 Chrome 的字型設定。 如要使用 Font Settings API,您必須宣告「fontSettings」 擴充功能的權限 資訊清單 。例如: Chrome 允許部分字型設定依特定的一般字型系列和語言 指令碼舉例來說,Sans-Serif 簡體中文使用的字型可能與字型不同 Serif 日文。 Chrome 支援的一般字型系列是以 CSS 一般字型系列 為基礎, 部分 API 參考資料當網頁指定一般字型系列時,Chrome
chrome.instanceID
使用 chrome.instanceID 存取執行個體 ID 服務。 重設應用程式執行個體 ID,並撤銷所有相關聯的權杖。 函式 選用 callback 參數如下所示: 承諾<void> Promise 僅適用於 Manifest V3 及以上版本,其他平台需要使用回呼。 撤銷授予的權杖。 物件 deleteToken 的參數。 字串 用來取得權杖的授權實體。 字串 用來取得權杖的範圍。 函式 選用 callback 參數如下所示: 承諾<void> Promise
chrome.gcm
使用 chrome.gcm 可讓應用程式和擴充功能透過 Firebase 雲端通訊 (FCM) 收發訊息。 訊息中所有鍵/值組合的大小上限 (以位元組為單位)。 4096 向 FCM 註冊應用程式。 callback 會傳回註冊 ID。如果系統以相同的 senderIds 清單再次呼叫 register ,會傳回相同的註冊 ID。 string[] 允許將訊息傳送至應用程式的伺服器 ID 清單。必須包含至少一個傳送者 ID,最多 100 個。 函式 選用 callback 參數如下所示: 字串
chrome.platformKeys
使用 chrome.platformKeys API 存取平台管理的用戶端憑證。如果使用者或政策授予權限,擴充功能就能在自訂驗證通訊協定中使用這類憑證。例如:這允許在第三方 VPN 中使用平台管理的憑證 (請參閱 chrome.vpnProvider )。 ArrayBuffer[] 伺服器允許的憑證授權單位辨別名稱清單。每個項目都必須是 DER 編碼的 X.509 DistinguishedName。 ClientCertificateType []
chrome.printingMetrics
使用 chrome.printingMetrics API 擷取列印使用情形的相關資料。 "BLACK_AND_WHITE" 指出使用的是黑白模式。 "COLOR" 指定使用的是色彩模式。 "ONE_SIDED" 指定使用了單面列印。 &quot;TWO_SIDED_LONG_EDGE&quot; 指明使用了雙面列印,在長邊翻轉。 &quot;TWO_SIDED_SHORT_EDGE&quot; 指定使用了雙面列印,在短邊緣翻轉。 數字 用於列印的媒體高度
chrome.devtools.inspectedWindow
使用 chrome.devtools.inspectedWindow API 與檢查的視窗互動:取得所檢查網頁的分頁 ID、評估所檢查視窗的程式碼、重新載入網頁,或是取得頁面中的資源清單。 您必須在 資訊清單中 宣告下列金鑰,才能使用這個 API。 使用 chrome.devtools.inspectedWindow 與檢查的視窗互動:取得分頁 ID 便根據檢查的視窗評估程式碼、重新載入網頁,或是取得 頁面中的資源清單 如要瞭解如何使用開發人員工具 API,請參閱「 開發人員工具 API 摘要
chrome.identity
使用 chrome.identity API 取得 OAuth2 存取權杖。 字串 帳戶的專屬 ID。在帳戶效期內,這個編號不會改變。 "SYNC" 指定已為主要帳戶啟用同步功能。 「ANY」 指定主要帳戶 (如果有的話) 的存在。 string[] 選填 已授予擴充功能的 OAuth2 範圍清單。 string optional 與要求相關聯的特定權杖。 字串 應從快取中移除的特定權杖。 AccountStatus 選用 主要帳戶登入設定檔的狀態,應傳回其 ProfileUserInfo
chrome.processes
使用 chrome.processes API 與瀏覽器的程序互動。 數字 使用的快取部分,以位元組為單位。 數字 快取的大小,以位元組為單位。 編號 選填 最新測量的處理程序 CPU 使用率,以程序所有執行緒總共使用單一 CPU 核心的百分比表示。這會將值從 0 變更為 CpuInfo.numOfProcessors*100,在多執行緒程序中,可能超過 100%。只有在從 onUpdated 或 onUpdatedWithMemory 的回呼中接收物件時,才會使用這個屬性。 快取 選用 程序的
chrome.history
使用 chrome.history API,與瀏覽器的瀏覽記錄互動。你可以在瀏覽器記錄中新增、移除及查詢網址。如要使用您的版本覆寫記錄頁面,請參閱 覆寫頁面 。 您必須宣告「history」 擴充功能資訊清單 中所列的權限,才能使用記錄 API。例如: History API 會使用「轉換類型」 說明瀏覽器前往特定網址的方式 即可。舉例來說,如果使用者點按其他網頁上的連結前往網頁, 轉場類型為「連結」 下表說明各種轉換類型。 如要試用這個 API,請前往
chrome.enterprise.hardwarePlatform
針對執行瀏覽器的硬體平台,您可以使用 chrome.enterprise.hardwarePlatform API 取得該硬體平台的製造商和型號。注意:這個 API 僅適用於由企業政策安裝的擴充功能。 字串 字串 取得硬體平台的製造商和型號;如果擴充功能經過授權,則會透過 callback 傳回。 函式 選用 callback 參數如下所示: HardwarePlatformInfo Promise&lt; HardwarePlatformInfo &gt; Promise
chrome.devtools.recorder
使用 chrome.devtools.recorder API 自訂開發人員工具中的「錄音工具」面板。 如要瞭解如何使用開發人員工具 API,請參閱「 開發人員工具 API 摘要 」一文。 devtools.recorder API 是一項預先發布版功能,可讓您擴充 Chrome 開發人員工具中的 錄音工具面板 。 你可以從 Chrome M105 開始擴充匯出功能。從 Chrome M112 開始,您可以擴充重播按鈕。 如要註冊擴充功能外掛程式,請使用
chrome.tts
使用 chrome.tts API 播放合成的文字轉語音 (TTS)。另請參閱相關的 ttsEngine API,這個 API 可讓擴充功能實作語音引擎。 Chrome 針對 Windows (使用 SAPI 5)、Mac OS X 和 ChromeOS 提供原生支援, 作業系統提供的語音合成功能在所有平台上,使用者可以 安裝本身註冊為替代語音引擎的擴充功能。 從擴充功能呼叫 speak() 即可說話。例如: 如要立即停止說話,只要呼叫 stop() 即可:
chrome.dom
使用 chrome.dom API 存取擴充功能的特殊 DOM API 取得指定元素代管的開放陰影根層級或封閉式陰影根目錄。如果元素沒有附加陰影根目錄,則會傳回空值。 HTMLElement 物件 詳情請參閱 https://developer.mozilla.org/en-US/docs/Web/API/ShadowRoot
chrome.tabCapture
使用 chrome.tabCapture API 與分頁媒體串流互動。 chrome.tabCapture API 可讓您存取 MediaStream ,其中包含影片 目前分頁的音訊。只有在使用者叫用擴充功能後才能呼叫這個方法,例如: 按一下擴充功能的 動作按鈕 。這類似於 activeTab 權限。 為分頁取得 MediaStream 後,系統就不會繼續播放該分頁中的音訊 以便傳達給使用者這與在發生下列情況時, getDisplayMedia() 函式的行為類似
chrome.webNavigation
使用 chrome.webNavigation API,即可接收關於傳輸中導航要求的狀態通知。 所有 chrome.webNavigation 方法和事件都必須宣告「webNavigation」權限 ,前往 擴充功能資訊清單 。例如: 導覽成功時,事件會按下列順序觸發: 程序期間發生的任何錯誤都會導致 onErrorOccurred 事件。針對特定 導覽,在 onErrorOccurred 之後不再觸發其他事件。 如果導覽頁框含有子頁框,系統會先觸發其 onCommitted
chrome.topSites
使用 chrome.topSites API 存取新分頁中顯示的熱門網站 (也就是最常造訪的網站)。但使用者自訂的捷徑不包括在內。 您必須宣告「top 網站」 擴充功能資訊清單 中的權限,才能使用這個 API。 如要試用這個 API,請安裝 chrome-extension-samples 提供的 top Sites API 範例 Cloud Storage 也提供目錄同步處理功能 這個物件會封裝最常造訪的網址,例如新分頁中的預設捷徑。 字串 頁面標題 字串 最常造訪的網址。 取得熱門網站清單。
chrome.management
chrome.management API 可讓您管理已安裝的應用程式和擴充功能。 您必須宣告「管理」 擴充功能資訊清單 中所列的權限,才能使用管理服務 也能使用 Google Cloud CLI 或 Compute Engine API例如: management.getPermissionWarningsByManifest 、 management.uninstallSelf 和 management.getSelf 不需要管理權限。 商品停用的原因。 "未知"
chrome.search
使用 chrome.search API 透過預設提供者搜尋。 "CURRENT_TAB" 指定搜尋結果會顯示在使用中瀏覽器的分頁或分頁中。 "NEW_TAB" 指定搜尋結果會顯示在新分頁中。 "NEW_WINDOW" 指定搜尋結果會顯示在新視窗中。 處理方式 選用 要顯示搜尋結果的位置。預設值為 CURRENT_TAB 。 編號 選填 要顯示搜尋結果的位置。 tabId 無法與 disposition 搭配使用。 字串 要使用預設搜尋引擎查詢的字串。
chrome.idle
使用 chrome.idle API 偵測機器閒置狀態變更的時間。 您必須宣告「閒置」權限,才能使用閒置 API。例如: "active" "idle" "已鎖定" 取得時間 (以秒為單位),直到螢幕自動鎖定為止。如果螢幕一律不會自動鎖定,則傳回零持續時間。目前僅支援 ChromeOS。 函式 選用 callback 參數如下所示: 數字 時間 (以秒為單位),直到螢幕在閒置狀態時自動鎖定為止。如果螢幕一律不會自動鎖定,則為 0。 Promise&lt;number&gt;
chrome.wallpaper
使用 chrome.wallpaper API 變更 ChromeOS 桌布。 您必須聲明「桌布」應用程式 資訊清單 中要使用的權限 桌布 API例如: 例如,如要將桌布設為 https://example.com/a_file.png ,你可以呼叫 chrome.wallpaper.setWallpaper : 支援的桌布版面配置。 "STRETCH" "CENTER" "CENTER_CROPPED" 將桌布設為 url 或 wallpaperData 搭配指定的 layout 物件
chrome.types
chrome.types API 包含 Chrome 的類型宣告。 ChromeSetting 原型提供一組常用函式 ( get() 、 set() 和 clear() ) Chrome 瀏覽器設定的事件發布者 ( onChange )。 Proxy 設定 。 Chrome 區分瀏覽器的設定有三種: Chrome 會管理不同層級的設定。以下清單說明可能的圖層 按優先順序遞增排序有效的設定 正如清單所指,政策可能會覆寫您透過擴充功能指定的任何變更。個人中心 可以使用 get()
chrome.enterprise.deviceAttributes
使用 chrome.enterprise.deviceAttributes API 讀取裝置屬性。注意:這個 API 僅適用於由企業政策強制安裝的擴充功能。 擷取管理員加註的位置。如果目前的使用者未聯盟,或管理員未設定已加註的位置,則會傳回空字串。 函式 選用 callback 參數如下所示: 字串 承諾<字串> Promise 僅適用於 Manifest V3 及以上版本,其他平台需要使用回呼。 擷取管理員註解的資產 ID。如果目前的使用者未建立關聯,或管理員未設定資產
chrome.windows
使用 chrome.windows API 與瀏覽器視窗互動。您可以使用這個 API 在瀏覽器中建立、修改及重新排列視窗。 系統要求時, windows.Window 會包含 tabs.Tab 物件的陣列。您必須 如要存取 url ,請在 資訊清單 中宣告 "tabs" 權限。 tabs.Tab 的 pendingUrl 、 title 或 favIconUrl 屬性。例如: 擴充功能系統中的許多函式都會使用選用 windowId 引數,該引數預設為 。 「目前的視窗」
chrome.power
使用 chrome.power API 覆寫系統的電源管理功能。 根據預設,作業系統會在使用者處於閒置狀態時調暗螢幕,最終將 有些人會將 Cloud Storage 視為檔案系統 但實際上不是只要使用 Power API,應用程式或擴充功能就能讓系統保持啟用狀態。 這個 API 可用於指定停用電源管理的 Level 。 "system" 水平儀,但允許螢幕變暗或關閉。舉例來說 即使螢幕關閉,通訊應用程式仍可繼續接收訊息。 "display"
chrome.pageCapture
使用 chrome.pageCapture API 將分頁儲存為 MHTML。 MHTML 是大部分瀏覽器支援的 標準格式 。可封裝在單一檔案中。 及其所有資源 (CSS 檔案、圖片) 請注意,基於安全考量,MHTML 檔案只能透過檔案系統載入,且 只會在主頁框中載入 您必須宣告「pageCapture」 擴充功能資訊清單 中的權限,才能使用 pageCapture 也能使用 Google Cloud CLI 或 Compute Engine API例如: 將指定 ID 的分頁內容儲存為
chrome.systemLog
使用 chrome.systemLog API 記錄擴充功能的 Chrome 系統記錄。 字串 這會新增記錄。 MessageOptions 記錄選項。 函式 選用 callback 參數如下所示: 承諾<void> Promise 僅適用於 Manifest V3 及以上版本,其他平台需要使用回呼。
chrome.fileSystemProvider
使用 chrome.fileSystemProvider API 建立可透過 Chrome 作業系統檔案管理員存取的檔案系統。 您必須宣告「fileSystemProvider」權限以及 擴充功能資訊清單 一節,要求使用 File System Provider API。例如: file_system_provider 部分必須宣告如下: Files 應用程式會使用上述資訊,適當轉譯相關的 UI 元素。舉例來說,如果 configurable 設為
chrome.privacy
在 Chrome 中,您可以使用 chrome.privacy API 控制哪些功能會影響使用者隱私。這個 API 需要運用 ChromeSetting 類型 API 原型 取得及設定 Chrome 的設定。 您必須聲明「隱私權」擴充功能 資訊清單 中具有使用 API 的權限。例如: 現在可以直接讀取 Chrome 設定目前的值。首先,您需要找出 請針對該物件呼叫 get() ,以便擷取 目前價值和擴充功能的控制層級例如,用於判斷 Chrome 的自動填入功能 此時應寫入:
chrome.notifications
使用 chrome.notifications API 即可利用範本建立複合式通知,並在系統匣中向使用者顯示這些通知。 string optional Mac OS X 使用者看不到按鈕圖示。 字串 字串 有關這個項目的其他詳細資料。 字串 其中一個清單通知項目的標題。 string optional Mac OS X 使用者不會看到應用程式圖示遮罩。 應用程式圖示遮罩的網址。網址的限制與 iconUrl 相同。 應用程式圖示遮罩應採用 Alpha 通道,因為系統只會考慮圖片的 Alpha
chrome.downloads
這項權限會 觸發警告 使用 chrome.downloads API,透過程式輔助方式啟動、監控、操控及搜尋下載內容。 您必須在 擴充功能資訊清單 中宣告 "downloads" 權限,才能使用這個 API。 您可以在 examples/api/downloads 找到 chrome.downloads API 的簡單使用範例。 目錄。如需其他範例及瞭解如何查看原始碼,請參閱「 範例 」。 布林值 選填 布林值 選填 檔案 下載的檔案名稱很可疑。 網址 已知的下載網址已知是惡意。 內容
chrome.devtools.network
使用 chrome.devtools.network API 可擷取開發人員工具在「網路」面板中顯示的網路要求相關資訊。 您必須在 資訊清單中 宣告下列金鑰,才能使用這個 API。 如要瞭解如何使用開發人員工具 API,請參閱「 開發人員工具 API 摘要 」一文。 網路要求資訊會以 HTTP 封存格式 ( HAR ) 表示。裝置的說明 HAR 不在本文件的範圍內,請參閱 HAR v1.2 規格 。 就 HAR 而言, chrome.devtools.network.getHAR()
chrome.vpnProvider
使用 chrome.vpnProvider API 實作 VPN 用戶端。 vpnProvider 的一般用法如下: 使用 createConfig 方法建立 VPN 設定。VPN 設定是永久性項目,會在 ChromeOS 原生 UI 中向使用者顯示。使用者可以從清單中選取 VPN 設定,並與其連線或中斷連線。 將事件監聽器新增至事件 onPlatformMessage 、 onPacketReceived 和 onConfigRemoved 。 當使用者連線至 VPN 設定時,會收到
chrome.proxy
使用 chrome.proxy API 管理 Chrome 的 Proxy 設定。這個 API 需要運用 ChromeSetting 類型 API 原型 取得及設定 Proxy 設定。 您必須宣告「proxy」請使用 擴充功能資訊清單 中的權限,才能使用 Proxy 設定 也能使用 Google Cloud CLI 或 Compute Engine API例如: Proxy 設定是在 proxy.ProxyConfig 物件中定義。視 Chrome 的 Proxy 設定而定 設定可能包含
chrome.printerProvider
chrome.printerProvider API 會公開列印管理員使用的事件,用於查詢擴充功能控制的印表機、查詢其功能,以及向這些印表機提交列印工作。 string optional 印表機的人類可讀說明。 字串 印表機專屬 ID。 字串 印表機的人類可讀名稱。 為回應 onPrintRequested 事件而傳回的錯誤代碼。 "OK" 表示作業已成功完成。 "FAILED" 表示發生一般錯誤。 "INVALID_TICKET"
chrome.events
chrome.events 命名空間包含 API 調度事件所使用的常見類型,可在有相關情況時通知您。 Event 物件可讓您在有有趣的事件發生時接收通知。以下是 根據 chrome.alarms.onAlarm 事件,在鬧鐘響起時收到通知: 如範例所示,您可以使用 addListener() 註冊通知。對 addListener() 一律是您定義的函式,用來處理事件,但 函式取決於您處理的事件。查看 alarms.onAlarm 的說明文件, 您可以看到函式有一個參數:包含詳細資料的
chrome.events
chrome.events 命名空間包含 API 調度事件所使用的常見類型,可在有相關情況時通知您。 Event 物件可讓您在有有趣的事件發生時接收通知。以下是 根據 chrome.alarms.onAlarm 事件,在鬧鐘響起時收到通知: 如範例所示,您可以使用 addListener() 註冊通知。對 addListener() 一律是您定義的函式,用來處理事件,但 函式取決於您處理的事件。查看 alarms.onAlarm 的說明文件, 您可以看到函式有一個參數:包含詳細資料的
chrome.idle
使用 chrome.idle API 偵測機器閒置狀態變更的時間。 您必須在擴充功能的資訊清單中宣告 "idle" 權限,才能使用閒置 API。例如: "active" "idle" "已鎖定" 取得時間 (以秒為單位),直到螢幕自動鎖定為止。如果螢幕一律不會自動鎖定,則傳回零持續時間。目前僅支援 ChromeOS。 函式 選用 callback 參數如下所示: 數字 時間 (以秒為單位),直到螢幕在閒置狀態時自動鎖定為止。如果螢幕一律不會自動鎖定,則為 0。
chrome.pageCapture
使用 chrome.pageCapture API 將分頁儲存為 MHTML。 MHTML 是大部分瀏覽器支援的 標準格式 。可封裝在單一檔案中。 及其所有資源 (CSS 檔案、圖片) 請注意,基於安全考量,MHTML 檔案只能透過檔案系統載入,且 只會在主頁框中載入 您必須宣告「pageCapture」 擴充功能資訊清單 中的權限,才能使用 pageCapture 也能使用 Google Cloud CLI 或 Compute Engine API例如: 將指定 ID 的分頁內容儲存為
chrome.offscreen
使用 offscreen API 建立及管理螢幕外文件。 如要使用 Offscreen API,請在 擴充功能資訊清單 中宣告 "offscreen" 權限。例如: 服務工作人員沒有 DOM 存取權,且許多網站都有內容安全政策, 內容指令碼的功能Offscreen API 允許擴充功能使用 DOM 將 API 放在隱藏的文件中,同時開啟新視窗或 標籤 runtime API 是唯一的擴充功能 API 。
chrome.fileSystemProvider
使用 chrome.fileSystemProvider API 建立可透過 Chrome 作業系統檔案管理員存取的檔案系統。 您必須宣告「fileSystemProvider」權限以及 擴充功能資訊清單 一節,要求使用 File System Provider API。例如: file_system_provider 部分必須宣告如下: Files 應用程式會使用上述資訊,適當轉譯相關的 UI 元素。舉例來說,如果 configurable 設為
chrome.management
chrome.management API 可讓您管理已安裝的應用程式和擴充功能。 您必須宣告「管理」 擴充功能資訊清單 中所列的權限,才能使用管理服務 也能使用 Google Cloud CLI 或 Compute Engine API例如: management.getPermissionWarningsByManifest() 、 management.uninstallSelf() 和 management.getSelf() 不需要管理權限。 商品停用的原因。 "未知"
chrome.debugger
chrome.debugger API 可做為 Chrome 遠端偵錯通訊協定 的替代傳輸方式。使用 chrome.debugger 附加至一或多個分頁,以檢測網路互動、對 JavaScript 進行偵錯、變更 DOM 和 CSS 等。使用 Debuggee 屬性 tabId 指定含有 sendCommand 的分頁,以及 tabId 從 onEvent 回呼的路徑事件。 您必須在擴充功能的資訊清單中宣告 "debugger" 權限,才能使用這個 API。 附加後,
chrome.omnibox
網址列 API 可讓您透過 Google Chrome 的網址列 (又稱為網址列) 註冊關鍵字。 使用者輸入擴充功能的關鍵字時,使用者只會開始與 。每個按鍵動作都會傳送至擴充功能,您可以提供回應建議。 這些建議可以使用多種格式。使用者接受建議後 您的擴充功能會收到通知,並可採取行動。 您必須在 資訊清單中 宣告下列金鑰,才能使用這個 API。 您必須在 資訊清單 中加入 "omnibox.keyword" 欄位,才能使用 Omnibox API。個人中心 也應該指定 16 x 16
chrome.downloads
使用 chrome.downloads API,透過程式輔助方式啟動、監控、操控及搜尋下載內容。 您必須在 擴充功能資訊清單 中宣告 "downloads" 權限,才能使用這個 API。 您可以在 examples/api/downloads 找到 chrome.downloads API 的簡單使用範例。 目錄。如需其他範例及瞭解如何查看原始碼,請參閱「 範例 」。 布林值 選填 布林值 選填 檔案 下載的檔案名稱很可疑。 網址 已知的下載網址已知是惡意。 內容 下載的檔案是惡意檔案。 不常見
chrome.history
使用 chrome.history API,與瀏覽器的瀏覽記錄互動。你可以在瀏覽器記錄中新增、移除及查詢網址。如要使用您的版本覆寫記錄頁面,請參閱 覆寫頁面 。 如要與使用者的瀏覽器紀錄互動,請使用 history API。 如要使用 History API,請在 擴充功能資訊清單 中宣告 "history" 權限。例如: History API 會使用轉換類型,說明瀏覽器如何前往特定網址 即可。舉例來說,如果使用者點按其他網頁上的連結前往網頁, 轉場類型為「連結」如需這份清單,請參閱 參考內容
chrome.notifications
使用 chrome.notifications API 即可利用範本建立複合式通知,並在系統匣中向使用者顯示這些通知。 string optional Mac OS X 使用者看不到按鈕圖示。 字串 字串 有關這個項目的其他詳細資料。 字串 其中一個清單通知項目的標題。 string optional Mac OS X 使用者不會看到應用程式圖示遮罩。 應用程式圖示遮罩的網址。網址的限制與 iconUrl 相同。 應用程式圖示遮罩應採用 Alpha 通道,因為系統只會考慮圖片的 Alpha
chrome.instanceID
使用 chrome.instanceID 存取執行個體 ID 服務。 重設應用程式執行個體 ID,並撤銷所有相關聯的權杖。 函式 選用 callback 參數如下所示: 承諾<void> Promise 適用於 Manifest V3 及以上版本,但系統會為 回溯相容性您無法在同一函式呼叫中同時使用兩者。 保證會以傳遞至回呼的相同類型來解析。 撤銷授予的權杖。 物件 deleteToken 的參數。 字串 用來取得權杖的授權實體。 字串 用來取得權杖的範圍。 函式 選用
chrome.gcm
使用 chrome.gcm 可讓應用程式和擴充功能透過 Firebase 雲端通訊 (FCM) 收發訊息。 訊息中所有鍵/值組合的大小上限 (以位元組為單位)。 4096 向 FCM 註冊應用程式。 callback 會傳回註冊 ID。如果系統以相同的 senderIds 清單再次呼叫 register ,會傳回相同的註冊 ID。 string[] 允許將訊息傳送至應用程式的伺服器 ID 清單。必須包含至少一個傳送者 ID,最多 100 個。 函式 選用 callback 參數如下所示: 字串
chrome.loginState
使用 chrome.loginState API 讀取及監控登入狀態。 "SIGNIN_PROFILE" 指定擴充功能位於登入設定檔中。 "USER_PROFILE" 指定擴充功能位於使用者設定檔中。 "UNKNOWN" 表示工作階段狀態不明。 "IN_OOBE_SCREEN" 用於指定使用者處於開箱體驗的畫面。 "IN_LOGIN_SCREEN" 指定使用者位於登入畫面。 "IN_SESSION" 指定使用者正在進行工作階段。 "IN_LOCK_SCREEN" 指定使用者位於螢幕鎖定畫面。
chrome.platformKeys
使用 chrome.platformKeys API 存取平台管理的用戶端憑證。如果使用者或政策授予權限,擴充功能就能在自訂驗證通訊協定中使用這類憑證。例如:這允許在第三方 VPN 中使用平台管理的憑證 (請參閱 chrome.vpnProvider )。 ArrayBuffer[] 伺服器允許的憑證授權單位辨別名稱清單。每個項目都必須是 DER 編碼的 X.509 DistinguishedName。 ClientCertificateType []
chrome.identity
使用 chrome.identity API 取得 OAuth2 存取權杖。 字串 帳戶的專屬 ID。在帳戶效期內,這個編號不會改變。 "SYNC" 指定已為主要帳戶啟用同步功能。 「ANY」 指定主要帳戶 (如果有的話) 的存在。 string[] 選填 已授予擴充功能的 OAuth2 範圍清單。 string optional 與要求相關聯的特定權杖。 字串 應從快取中移除的特定權杖。 AccountStatus 選用 主要帳戶登入設定檔的狀態,應傳回其 ProfileUserInfo
chrome.dom
使用 chrome.dom API 存取擴充功能的特殊 DOM API 取得指定元素代管的開放陰影根層級或封閉式陰影根目錄。如果元素沒有附加陰影根目錄,則會傳回空值。 HTMLElement 物件 詳情請參閱 https://developer.mozilla.org/en-US/docs/Web/API/ShadowRoot
chrome.browsingData
使用 chrome.browsingData API 從使用者本機設定檔移除瀏覽資料。 您必須在 擴充功能資訊清單 中宣告 "browsingData" 權限,才能使用這個 API。 此 API 最簡單的用途,是清除使用者的瀏覽資料,以時間為基礎的機制。 您的程式碼應提供時間戳記,指出使用者的 就必須移除瀏覽資料。該時間戳記的格式為毫秒數, Unix 紀元 (可使用 getTime() 方法從 JavaScript Date 物件擷取)。
chrome.system.memory
chrome.system.memory API。 數字 可用容量量,以位元組為單位。 數字 實體記憶體總容量 (以位元組為單位)。 取得實體記憶體資訊。 函式 選用 callback 參數如下所示: MemoryInfo Promise&lt; MemoryInfo &gt; Promise 僅適用於 Manifest V3 及以上版本,其他平台需要使用回呼。
chrome.desktopCapture
桌面擷取 API 會擷取畫面內容、個別視窗或個別分頁。 列舉用來定義在 chooseDesktopMedia() 中使用的電腦媒體來源組合。 "螢幕" "視窗" 「分頁」 "音訊" 鏡像 SelfCapturePreferenceEnum 。 "加入" "排除" 鏡像 SystemAudioPreferenceEnum 。 "加入" "排除" 隱藏由 chooseDesktopMedia() 顯示的電腦版媒體選擇器對話方塊。 數字 ChooseDesktopMedia() 傳回的 ID
chrome.dns
使用 chrome.dns API 進行 DNS 解析。 如要使用這個 API,您必須在 資訊清單 中宣告 "dns" 權限。 以下程式碼會呼叫 resolve() 以擷取 example.com 的 IP 位址。 service-worker.js: string optional 代表 IP 位址常值的字串。僅在 resultCode 表示成功時提供。 數字 結果代碼。零表示成功。 解析指定的主機名稱或 IP 位址常值。 字串 要解析的主機名稱。 函式 選用 callback 參數如下所示:
chrome.documentScan
使用 chrome.documentScan API,從附加的文件掃描器中探索及擷取圖片。 Document Scan API 的設計用意在允許應用程式和擴充功能 文件掃描器上的紙本文件內容。 字串 提供傳遞至 cancelScan() 的相同工作控制代碼。 OperationResult 後端的取消掃描結果。如果結果是 OperationResult.SUCCESS 或 OperationResult.CANCELLED ,表示掃描已取消,掃描器已可開始新的掃描作業。如果結果是
chrome.declarativeWebRequest
注意: 這個 API 已淘汰,請改用 declarativeNetRequest API。 使用 chrome.declarativeWebRequest API 攔截、封鎖或修改傳輸中的要求。速度比 chrome.webRequest API 快許多;由於您可以註冊要在瀏覽器中評估的規則 (而非 JavaScript 引擎),藉此減少往返延遲時間,並提高處理效率。 您必須宣告「declarativeWebRequest」 擴充功能資訊清單 中的權限,才能使用擴充功能 API,以及 主機權限 。
API 參考資料
Chrome 擴充功能所提供所有 API 的完整參考資料。包括已淘汰的 Chrome 應用程式平台的 API,以及仍處於 Beta 版和開發階段的 API。
chrome.alarms
如要安排定期或日後指定時間執行程式碼,請使用 chrome.alarms API。 如要使用 chrome.alarms API,請在 資訊清單 中宣告 "alarms" 權限: 下列範例說明如何使用及回應鬧鐘。如要試用這個 API, 從 chrome-extension-samples 安裝 Alarm API 範例 Cloud Storage 也提供目錄同步處理功能 下列範例會在安裝擴充功能時,在 Service Worker 中設定鬧鐘: service-worker.js:
chrome.contextMenus
如要在 Google Chrome 的內容選單中新增項目,請使用 chrome.contextMenus API。你可以選擇要在內容選單中新增的物件類型,例如圖片、超連結和頁面。 內容選單項目可顯示在任何文件 (或文件內的頁框) 中,即使是具有 file:// 的項目也能顯示 或 chrome:// 網址如要控制檔案可以顯示在哪些文件,請指定 呼叫 create() 或 update() 方法時,系統會傳回 documentUrlPatterns 欄位。
chrome.debugger
chrome.debugger API 可做為 Chrome 遠端偵錯通訊協定 的替代傳輸方式。使用 chrome.debugger 附加至一或多個分頁,以檢測網路互動、對 JavaScript 進行偵錯、變更 DOM 和 CSS 等。使用 Debuggee 屬性 tabId 指定含有 sendCommand 的分頁,以及 tabId 從 onEvent 回呼的路徑事件。 基於安全考量, chrome.debugger API 不提供所有 Chrome
chrome.audio
使用者可以利用 chrome.audio API 取得及控制系統連接的音訊裝置相關資訊。這個 API 目前只能在 ChromeOS 的 Kiosk 模式中使用。 字串 裝置名稱。 DeviceType 裝置的類型。 字串 容易使用的名稱 (例如「USB 麥克風」)。 字串 音訊裝置的專屬 ID。 布林值 如果這是目前使用中的裝置,則為「true」。 數字 裝置的聲音水平、輸出的音量、輸入的增益。 string optional 穩定/持久裝置 ID 字串 (如有)。 StreamType
chrome.declarativeContent
使用 chrome.declarativeContent API 根據網頁內容採取行動,而不要求讀取網頁內容。 Declarative Content API 可讓你根據 或是 CSS 選取器與網頁上的元素相符 新增 主機權限 或插入 內容指令碼 。 使用 activeTab 權限,在使用者點選 擴充功能的動作。 規則由條件和動作組成。只要符合任一條件,系統就會執行所有動作 執行狀態這些動作為 setIcon 和 showAction 。 只有在所有列出的清單都符合時,
chrome.commands
你可以使用 Command API 新增鍵盤快速鍵,在擴充功能中觸發動作,例如開啟瀏覽器動作或傳送指令給擴充功能。 您必須在 資訊清單中 宣告下列金鑰,才能使用這個 API。 Commands API 可讓擴充功能開發人員定義特定指令,並將指令繫結至預設值 按鍵組合。擴充功能接受的每個指令都必須宣告為 擴充功能資訊清單 中的 "commands" 物件。 屬性索引鍵會做為指令的名稱。指令物件可以採用兩種屬性。
chrome.browsingData
使用 chrome.browsingData API 從使用者本機設定檔移除瀏覽資料。 您必須宣告「browsingData」權限,請參閱 擴充功能資訊清單 中的權限,以便使用這個 API。 此 API 最簡單的用途,是清除使用者的瀏覽資料,以時間為基礎的機制。 您的程式碼應提供時間戳記,指出使用者的 就必須移除瀏覽資料。該時間戳記的格式為毫秒數, Unix 紀元 (可透過 getTime 方法從 JavaScript Date 物件擷取)。
範例
如需 Chrome 擴充功能的範例,請參閱 GitHub 。
發布應用程式
TODO
Chrome 擴充功能有哪些地方?'
概略說明 Chrome 擴充功能的近期異動,以及開發人員可期待即將推出的擴充功能功能。
Chrome 擴充功能:重要政策更新
本次公告包含對《開發人員計畫政策》頁面進行一系列的修訂,旨在鼓勵開發人員開發優質產品、防範欺騙行為,並確保使用者在知情的情況下提供同意聲明。
在 YouTube 新增值得信賴的類型
YouTube 已採用「信任的類型」強化平台安全性,可防範跨網站指令碼攻擊,不過可能會影響擴充功能。
Chrome 線上應用程式商店幕後花絮:詢問信任與安全問題
我們與負責 Chrome 線上應用程式商店審查的團隊告一段落。
資訊清單 - 最低 Chrome 版本
manifest.json 的 min_chrome_version 屬性參考說明文件。
資訊清單 - 試用權杖
manifest.json 的 trial_tokens 屬性參考說明文件。
Chrome 擴充功能有哪些地方?'
概略說明 Chrome 擴充功能的近期異動,以及開發人員可期待即將推出的擴充功能功能。
Chrome 線上應用程式商店開發人員資訊主頁的版本復原功能
本週,我們很高興推出一項新功能,讓開發人員將擴充功能回溯至先前在 Chrome 線上應用程式商店發布的版本。我們的目標是讓開發人員在發布更新時更安心,尤其是在改用資訊清單 V3 的情況下。 從今天起,您不必提交有錯誤修正的擴充功能新版本,然後等待審查通過。您可以透過「更多」 選單或項目的套件頁面,啟動回溯作業。 復原作業需要新版本號碼,以便重新發布擴充功能的舊版本,並提供復原的原因。填寫必要資訊後,請確認還原作業。 回溯完成後,系統會透過 Chrome
打造無障礙擴充功能
對許多使用者來說,無障礙工具本來就是使用者介面,而其功能對許多使用者來說非常實用。
將介面國際化
使用 chrome.i18n API 以多種語言呈現介面。
Chrome 擴充功能:eyeo'測試服務工作人員停權作業的流程
眼神團隊在這篇文章中分享了自己在測試擴充功能服務工作人員問題的心路歷程。尤其是當服務工作人員遭到停權時,如何確保 Chrome 擴充功能正常運作。
設定擴充功能圖示
擴充功能至少需要一個圖示,才能在工具列中代表該擴充功能。
遷移至 Manifest V3
本指南說明如何將 Manifest V2 擴充功能轉換為 Manifest V3 擴充功能。
使用 WebHID
WebHID API 可透過擴充功能在網路上公開與人機介面裝置 (HID) 的相容裝置。
使用 WebUSB
WebUSB API 可透過擴充功能在網路上公開非標準通用序列匯流排 (USB) 相容裝置,
資訊清單 - 內容安全政策
manifest.json 內容安全性政策屬性的參考說明文件。
chrome.runtime
使用 chrome.runtime API 擷取服務工作者、傳回資訊清單的詳細資料,並監聽擴充功能生命週期中的事件並做出回應。您也可以使用這個 API,將網址的相對路徑轉換為完整網址。 這個 API 的大多數成員「不需要」 任何權限。 connectNative() 、 sendNativeMessage() 和 onNativeConnect 需要這項權限。 以下範例說明如何在資訊清單中宣告 "nativeMessaging" 權限: manifest.json: Runtime API
使用網路推播
透過 Chrome 擴充功能使用網路推播的逐步指南
權限警告指南
權限警告在 Chrome 擴充功能中的運作方式。
宣告權限
manifest.json 中權限屬性的有效值總覽。
回應指令
回應額外資訊中的自訂按鍵組合。
Chrome 擴充功能有哪些地方?'
概略說明 Chrome 擴充功能的近期異動,以及開發人員可期待即將推出的擴充功能功能。
透過網址列觸發動作
透過網址列觸發動作。
搭配 chrome.gcm 使用 Firebase 雲端通訊 (FCM)
透過 chrome.gcm 使用 Firebase 通訊的逐步指南
實作動作
回應使用者點按工具列。
建構內容選單
實作彈出式視窗,讓使用者在其中叫用擴充功能功能。
處理遠端代管程式碼違規問題
Service Worker 可讓擴充功能只在需要時執行,藉此節省資源。
新增彈出式視窗
實作彈出式視窗,讓使用者在其中叫用擴充功能功能。
繼續轉換至 Manifest V3
去年 12 月,我們暫停了原訂的 Manifest V2 淘汰計畫,以便回應開發人員的意見,並提供更完善的 遷移問題 解決方案。根據這項意見回饋,我們對 Manifest V3 進行了多項變更,以 彌補這些差距 ,包括: 除了彌補缺口,我們也為平台新增了許多新功能,例如今年初推出的 Side Panel API ,以及目前處於 Beta 版的 Reading List API 。我們最近在廣告篩選開發人員大會上討論了許多這類變更,並 分享 更多資訊,說明我們根據意見回饋所做的變更和改善。
改善 Manifest V3 的內容篩選功能
過去一年,我們積極與多個內容封鎖擴充功能的供應商討論,尋找改善 MV3 擴充功能平台的方法。根據這些討論 (其中許多是在 WebExtensions 社群群組 ( WECG ) 與其他瀏覽器合作時進行),我們已推出許多重大改善措施。 篩選器規則通常會分組成清單。舉例來說,較一般性的清單可能包含適用於所有使用者的規則,而較具體的清單則可能隱藏特定地點的內容,只有部分使用者想封鎖這些內容。在此之前,我們允許每個擴充功能為使用者提供 50 個清單 (或「靜態規則集」) 供選擇,並同時啟用其中 10
Chrome 120 擴充功能的新功能
Chrome 120 版中適用於 Chrome 擴充功能開發人員的重要異動摘要。
在 Chrome OS 上處理檔案
如何在 Chrome 擴充功能服務工作站、彈出式視窗、側邊面板或內容指令碼中開啟檔案。
file_handlers
manifest.json 的 file_handlers 屬性參考說明文件。
Chrome 擴充功能有哪些地方?'
概略說明 Chrome 擴充功能的近期異動,以及開發人員可期待即將推出的擴充功能功能。
Chrome 擴充功能單元測試
如何撰寫擴充功能的單元測試。
使用 Puppeteer 測試 Chrome 擴充功能
如何使用 Puppeteer 為 Chrome 擴充功能編寫自動化測試。
Chrome 擴充功能的端對端測試
如何針對擴充功能編寫端對端測試。
回報擴充功能錯誤
如何回報擴充功能錯誤或說明文件問題。
尋找及追蹤錯誤
檢查是否已回報錯誤或功能要求。
開發人員工具提示:對 Chrome 擴充功能進行偵錯
瞭解如何使用開發人員工具對 Chrome 擴充功能進行偵錯。
發布擴充功能
發布新的 Manifest V3 擴充功能的指南
Google Summer of Code 和 Chrome 擴充功能
獲得參加 Google Summer of Code 的經驗和建議。
將安全檢查功能導入 chrome://extensions 頁面
從 Chrome 117 版開始,如果 Chrome 線上應用程式商店不再提供使用者所安裝的擴充功能,Chrome 會主動向使用者強調。
資訊清單 - 內容指令碼
manifest.json 的 "content_scripts" 屬性參考說明文件。
Chrome 116 版擴充功能的新功能
Chrome 116 版中適用於 Chrome 擴充功能開發人員的重要異動摘要。
Chrome 擴充功能有哪些地方?'
Chrome 擴充功能今年到目前為止的異動總覽,以及開發人員預計即將推出的擴充功能功能。
在 Service Worker 中使用 WebSocket
透過 Chrome 擴充功能連線至 WebSocket 的逐步操作說明。
使用地理位置
如何在 Chrome 擴充功能服務工作站、彈出式視窗、側邊面板或內容指令碼中使用地理位置。
資訊清單 - 背景
manifest.json 的背景屬性參考說明文件。
關於擴充功能服務工作處理程序
擴充功能服務工作站是一個擴充功能' 中央事件處理常式。因此與網路服務工作站不同。
Service Worker 中的事件
擴充功能服務工作站會回應標準服務工作站事件,以及擴充功能 API 中的許多事件。
擴充功能 Service Worker 基本概念
擴充功能 Service Worker 的安裝和更新方式與網路服務工作站不同。
擴充功能服務工作站生命週期
擴充功能服務工作站會回應標準服務工作站事件和擴充功能命名空間中的事件。這是因為在擴充功能中使用時,常常會伴隨另一種類型出現。
音訊錄音和螢幕畫面擷取
如何錄製分頁、視窗或畫面的音訊或視訊內容。
使用服務工作程處理事件
瞭解如何建立及偵錯擴充功能服務 worker。
更新程式碼
前三個部分說明瞭非擴充功能 Service Worker 所需的程式碼變更。
更新資訊清單
manifest.json 檔案和 Manifest V2 的 Manifest V3 資料格式略有不同。
遷移至 Service Worker
Service Worker 可讓擴充功能只在需要時執行,藉此節省資源。
取代封鎖網路要求監聽器
第三個章節的第二部分說明需針對非擴充功能 Service Worker 的程式碼進行的變更。
提升擴充功能安全性
最後三個部分,說明非擴充功能 Service Worker 需要的程式碼變更。
原生訊息傳遞
與 Chrome 擴充功能中的原生應用程式交換訊息。
取得 Chrome 擴充功能相關說明
如果對說明文件未涵蓋的問題有疑問,該到哪裡尋求協助。
更長的擴充功能服務工作站生命週期
擴充功能服務工作處理程序現在可以在接收事件時,只要一直保持 #39 狀態,這會提高擴充功能服務工作站的可靠性,但應避免帶來必須避免的陷阱。
Manifest V3 中的螢幕外文件
隆重推出適用於 Chrome 擴充功能開發的 Offscreen Documents API。
正在擷取網站小圖示
如何建立網站小圖示's 網站小圖示。
Chrome 線上應用程式商店政策更新
Chrome 即將更新 Chrome 線上應用程式商店';《開發人員計畫政策》將明確指出指導原則、提供更多違規處置的相關資訊,並讓政策內容更清楚易懂。
資訊清單 - OAuth2
manifest.json 的 OAuth2 屬性參考說明文件。
Chrome 線上應用程式商店政策更新
Chrome 即將更新 Chrome 線上應用程式商店';《開發人員計畫政策》將明確指出指導原則、提供更多違規處置的相關資訊,並讓政策內容更清楚易懂。
資訊清單 - input_components
manifest.json 的 input_components 屬性參考說明文件。
展開 Chrome 擴充功能開發歷程的新方式
更好的開始 Chrome 開發人員學習之旅。
在每個網頁上執行指令碼
瞭解如何自動將新元素新增至現有網頁。
管理分頁
瞭解如何透過程式碼使用分頁群組來整理分頁。
Hello World 擴充功能
建立第一個 Hello World Chrome 擴充功能。
將指令碼插入使用中的分頁
瞭解如何簡化目前網頁的樣式。
資訊清單 - 作者
manifest.json 作者名稱屬性的參考說明文件。
進一步瞭解如何改用 Manifest V3
針對將擴充功能移至 Manifest V3 的計畫新增詳細資料
Chrome 線上應用程式商店開發人員資訊主頁推出新版 Analytics (分析)
Google 為 Chrome 線上應用程式商店開發人員資訊主頁推出改良版商品數據分析體驗。新版資訊主頁能讓使用者一目瞭然,並且直接整合最實用的資訊,
2021 年第 3 季的 Chrome 線上應用程式商店政策更新
更新安全性規定,並進一步釐清幾項政策,確保擴充功能的品質優良,並提供開發人員一致的體驗。
將 Chrome 擴充功能轉換至 Manifest V3
說明將擴充功能移至 Manifest V3 的計畫詳情
跨來源隔離
擴充功能的跨來源隔離總覽
跨來源開啟工具政策
manifest.json 的 cross_origin_opener_policy 屬性參考說明文件。
跨來源嵌入程式政策
manifest.json 的 cross_origin_embedder_policy 屬性參考說明文件。
跨來源開啟工具政策
manifest.json 的 cross_origin_opener_policy 屬性參考說明文件。
跨來源嵌入程式政策
manifest.json 的 cross_origin_embedder_policy 屬性參考說明文件。
Chrome 擴充功能:闡明擴充功能政策,提供更安全且一致的線上應用程式商店
更新安全性規定,並進一步釐清幾項政策,確保擴充功能的品質優良,並提供開發人員一致的體驗。
關於 Manifest V2
Chrome 擴充功能開發人員專用的說明文件。
使用者主機權限控制項:轉換指南
從 Chrome 70 版開始,更新擴充功能以處理執行階段主機權限變更的指南。
內嵌安裝淘汰作業常見問題
有關 Chrome 擴充功能內嵌安裝功能淘汰作業的常見問題。
遷移至事件導向背景指令碼
如何將永久背景指令碼遷移至事件型的非永久模型,以提升 Chrome 擴充功能的效能。
達到最佳成效
說明如何建構高效能 Chrome 擴充功能的指南。
保護使用者隱私
可確保 Chrome 擴充功能保護使用者隱私的相關指南。
保護使用者隱私
可確保 Chrome 擴充功能保護使用者隱私的相關指南。
設計使用者介面
Chrome 擴充功能的使用者介面和設計指南。
保障帳戶安全
如何維護 Chrome 擴充功能的安全。
保障帳戶安全
如何維護 Chrome 擴充功能的安全。
Linux 自行託管
如何從個人伺服器封裝、代管及更新 Linux 使用者適用的 crx 檔案。
在 Linux 上安裝擴充功能
如何從個人伺服器封裝、代管及更新 crx 檔案。
event_rules
manifest.json 的 event_rules 屬性的參考說明文件。
event_rules
manifest.json 的 event_rules 屬性的參考說明文件。
共用模組
如何在 Chrome 擴充功能之間共用程式碼。
共用模組
如何在 Chrome 擴充功能之間共用程式碼。
多樣化通知 API
如何為 Chrome 擴充功能使用者顯示通知。
使用通知 API
向 Chrome 擴充功能使用者顯示通知。
Chrome 33 代管變更
針對於 Chrome 第 33 版啟動的 Chrome 擴充功能所進行的代管異動詳細資料。
常見問題
Chrome 擴充功能的常見問題。
教學課程:遷移至 Manifest V2
從資訊清單 v1 遷移至資訊清單 v2 的指南。
開始使用
建立 Chrome 擴充功能的逐步操作說明。
chrome.location
chrome.location API 的參考說明文件。
覆寫 Chrome 設定
如何覆寫 Chrome 擴充功能中的 Chrome 設定。
覆寫 Chrome 設定
如何覆寫 Chrome 擴充功能中的 Chrome 設定。
代管儲存空間的資訊清單
manifest.json 的儲存屬性參考說明文件。
儲存區域的資訊清單
manifest.json 的儲存屬性參考說明文件。
externally_connectable
manifest.json 的 external_connectable 屬性的參考說明文件。
externally_connectable
manifest.json 的 external_connectable 屬性的參考說明文件。
資訊清單 - 名稱
manifest.json 名稱屬性的參考說明文件。
資訊清單 - Nacl 模組
manifest.json 的 nacl_modules 屬性參考說明文件。
資訊清單 - 可供網路存取的資源
manifest.json 的 web_access_resources 屬性參考說明文件。
資訊清單 - 可供網路存取的資源
manifest.json 的 web_access_resources 屬性參考說明文件。
資訊清單 - 無痕模式
manifest.json 的無痕模式屬性參考說明文件。
資訊清單 - 說明
manifest.json 說明屬性的參考說明文件。
資訊清單 - 版本
manifest.json 版本屬性的參考說明文件。
資訊清單 - 最低 Chrome 版本
manifest.json 的 min_chrome_version 屬性參考說明文件。
Manifest V2 - 版本 [已淘汰]
manifest.json 版本屬性的參考說明文件。
資訊清單 - 鍵
manifest.json 金鑰屬性的參考說明文件。
資訊清單 - 規定
manifest.json 的要求屬性的參考說明文件。
資訊清單 - 沙箱
manifest.json 的沙箱屬性參考說明文件。
資訊清單 - 圖示
manifest.json 的圖示屬性參考說明文件。
資訊清單 - 已啟用離線功能
manifest.json 的離線_enabled 屬性參考說明文件。
資訊清單 - 規定
manifest.json 的要求屬性的參考說明文件。
資訊清單:姓名和簡稱
manifest.json 的名稱和 short_name 屬性參考說明文件。
資訊清單版本
manifest.json 的 manifest_version 屬性參考說明文件。
資訊清單 - 預設語言代碼
manifest.json 的 default_locale 屬性參考說明文件。
資訊清單 - 首頁網址
manifest.json 的 home_url 屬性參考說明文件。
資訊清單 - short_name
manifest.json 的 short_name 屬性參考說明文件。
資訊清單 - 沙箱
manifest.json 的沙箱屬性參考說明文件。
資訊清單 - 圖示
manifest.json 的圖示屬性參考說明文件。
資訊清單 - 鍵
manifest.json 金鑰屬性的參考說明文件。
資訊清單 - 無痕模式
manifest.json 的無痕模式屬性參考說明文件。
資訊清單 - 說明
manifest.json 說明屬性的參考說明文件。
資訊清單 - 首頁網址
manifest.json 的 home_url 屬性參考說明文件。
資訊清單 - 預設語言代碼
manifest.json 的 default_locale 屬性參考說明文件。
什麼是擴充功能?
Chrome 擴充功能的用途及開發方式總覽。
宣告權限
manifest.json 中權限屬性的有效值總覽。
Active Tab 權限
如何在 Chrome 擴充功能中使用有效分頁權限。
「"activeTab&」權限
如何在 Chrome 擴充功能中使用有效分頁權限。
覆寫 Chrome 網頁
如何覆寫 Chrome 書籤管理員、歷史記錄和新分頁中的 Chrome 擴充功能。
偵錯擴充功能
說明如何對 Chrome 擴充功能進行偵錯。
訊息傳遞
如何在擴充功能和內容指令碼之間傳遞訊息。
比對模式
瞭解 Chrome 擴充功能中的網址比對模式。
使用 Google Analytics (分析) 4
透過 Google Analytics (分析) 4 追蹤擴充功能使用情況的逐步操作說明。
在沙箱 iframe 中使用 eval()
如何在 Chrome 擴充功能中使用 eval()。
教學課程:Google Analytics (分析)
透過 Google Analytics (分析) 追蹤擴充功能使用方式的逐步操作說明。
為使用者提供選項
如何讓使用者自訂擴充功能。
本地化訊息格式
Chrome 擴充功能的 messages.json 檔案格式參考說明文件。
訊息傳遞
如何在擴充功能和內容指令碼之間傳遞訊息。
什麼是主題?
主題建立指南。
在 Chrome 擴充功能中使用 eval
如何在 Chrome 擴充功能中使用 eval()。
跨來源 XMLHttpRequest
如何在 Chrome 擴充功能中實作跨來源 XHR。
覆寫 Chrome 網頁
如何覆寫 Chrome 書籤管理員、歷史記錄和新分頁中的 Chrome 擴充功能。
資訊清單版本
manifest.json 的 manifest_version 屬性會指出 Chrome 擴充功能指定的資訊清單規格版本。
資訊清單檔案格式
Chrome 擴充功能的 manifest.json 屬性總覽。
OAuth2:透過 Google 驗證使用者
逐步說明如何建立擴充功能,以便透過 Google People API、Chrome Identity API 和 OAuth2 存取使用者的 Google 聯絡人。
資訊清單檔案格式
概略瞭解可在 Chrome 擴充功能中使用的 manifest.json 屬性。
為使用者提供選項
如何讓使用者自訂擴充功能。
偵錯擴充功能
對 Chrome 擴充功能偵錯的逐步操作說明。
宣告權限並警告使用者
如何實作權限以保護使用者和擴充功能。
OAuth 2.0:透過 Google 驗證使用者
逐步說明如何建立擴充功能,以便透過 Google People API、Chrome Identity API 和 OAuth2 存取使用者的 Google 聯絡人。
架構總覽
Chrome 擴充功能軟體架構的概要說明。
Chrome Web Store
如何在 Chrome 線上應用程式商店代管擴充功能,並更新 Chrome 線上應用程式商店代管的擴充功能 (')。
什麼是主題?
主題建立指南。
比對模式
主機權限和內容指令碼模式比對方式及範例。
跨來源網路要求
在 Chrome 擴充功能中實作跨來源網路要求。
擴充開發人員工具
如何建立為 Chrome 開發人員工具新增功能的 Chrome 擴充功能。
使用其他安裝方法
如何使用偏好設定 JSON 或 Windows 登錄檔安裝 Chrome 擴充功能。
使用背景指令碼管理事件
如何從 Chrome 擴充功能背景指令碼回應瀏覽器觸發事件 (事件)。
擴充功能開發總覽
Chrome 擴充功能功能和元件總覽。
內容指令碼
內容指令碼說明,以及如何在 Chrome 擴充功能中使用這些指令碼。
透過 webKit 執行複合式通知
如何在 Chrome 擴充功能中實作通知。
內容指令碼
內容指令碼說明,以及如何在 Chrome 擴充功能中使用這些指令碼。
無障礙設計 (a11y)
如何開放 Manifest V2 Chrome 擴充功能存取。
擴充開發人員工具
如何建立 Chrome 擴充功能,為 Chrome 開發人員工具添加功能。
其他擴充功能發布選項
如何在 Chrome 線上應用程式商店以外的地方發布 Chrome 擴充功能。
支援無障礙功能
如何開放存取 Chrome 擴充功能。
Policies
Extension policies
Google Play for Education Addendum to the Google Chrome Web Store Developer Agreement
In connection with the Google Chrome Web Store, Google may make certain Chrome Web Store applications available in Google's Play for Education site. If You or Your organization is interested in participating, please verify that the
Chrome Web Store API Reference
This reference describes the methods and resource representation available for the Chrome Web Store Publish API. Each resource type has one or more data representations and one or more methods. See Using the Chrome Web Store Publish API for a guide
Use the Chrome Web Store Publish API
How to programmatically create, update, and publish items in the Chrome Web Store.
Chrome Web Store
Chrome Web Store An online marketplace where users can browse for extensions and themes. Publish your extension there and make it accessible to the world. dashboard Developer Dashboard Publish your extension and manage your store items. local_mall
Prepare your extension as we begin testing a new extensions menu
How to prepare your extension for the new extensions menu.
Creating a great listing page
Best practices on how to make a high-quality, engaging listing page for your item in the Chrome Web Store.
Deceptive Installation Tactics FAQ
Frequently asked questions about Chrome Web Store's policies on deceptive installation tactics.
Deceptive Installation Tactics
Extensions must be marketed responsibly. The set of functionalities promised by the extension must be stated clearly and in a transparent manner. The outcome of any user interaction should match the reasonable expectations that were set with the
Quality guidelines
An extension must have a single purpose that is narrow and easy to understand. Don't create an extension that requires users to accept bundles of unrelated functionality. If two pieces of functionality are clearly separate, they should be put into
Best Practices and Guidelines
Research and understand the Chrome Web Store policies. Before developing a Chrome extension, it is important to review the Chrome Web Store Developer Program Policies and ensure your extension complies with all guidelines and requirements. Extensions
Extensions quality guidelines FAQ
Frequently asked questions about the single purpose policy.
Listing Requirements
If your product has a blank description field or is missing an icon or screenshots, it will be rejected. Ensure your product's listing information is up to date, accurate, and comprehensive. We don't allow extensions with misleading, inaccurate,
Extensions / Develop
Learn how to develop extensions
Content filtering
An explanation of content filtering and how to approach it in your Chrome Extension.
chrome.accessibilityFeatures
Use the chrome.accessibilityFeatures API to manage Chrome's accessibility features. This API relies on the ChromeSetting prototype of the type API for getting and setting individual accessibility features. In order to get feature states the extension
chrome.accessibilityFeatures
Use the chrome.accessibilityFeatures API to manage Chrome's accessibility features. This API relies on the ChromeSetting prototype of the type API for getting and setting individual accessibility features. In order to get feature states the extension
chrome.extensionTypes
The chrome.extensionTypes API contains type declarations for Chrome extensions. The origin of injected CSS. "author" "user" Details of the CSS to remove. Either the code or the file property must be set, but both may not be set at the same time.
chrome.extensionTypes
The chrome.extensionTypes API contains type declarations for Chrome extensions. The origin of injected CSS. "author" "user" Details of the CSS to remove. Either the code or the file property must be set, but both may not be set at the same time.
Skip review for eligible changes
An overview of expedited review for Declarative Net Request changes.
Rollback a published Chrome Web Store item
How to rollback an extension that you previously published on the
Additional Requirements for Manifest V3
Extensions using Manifest V3 must meet additional requirements related to the extension's code. Specifically, the full functionality of an extension must be easily discernible from its submitted code, unless otherwise exempt as noted in Section 2.
Extensions / How to
Solve common development tasks around Chrome extensions
Mature & Sexually Explicit Material
We don't allow content that contains nudity, graphic sex acts, sexually explicit material, or content that drives traffic to commercial pornography sites. We also don't allow content that promotes incest, bestiality, necrophilia, or non-consensual
chrome.location
The chrome.location API is no longer supported. We recommend using open web alternatives such as the Geolocation API instead.
Register your developer account
How to register as a Chrome Web Store developer.
Trader/Non-Trader developer identification and verification
Developer's requirement to disclose and verify their trader/non-trader status.
Extensions / Samples
Samples Explore samples from the Chrome Extension samples repository. Use these to learn how extensions work or as starting points for building your own extensions. action.disable action.enable action.getBadgeBackgroundColor action.getBadgeText
Permissions
A list of permissions and user warnings available on the extensions platform.
Program Policies
The Web Store program policies.
Real-time Updates in Extensions
Managing real-time updates in Extensions
Distribute your extension
How to host your Chrome extension.
Extensions / Reference
Reference for the extensions manifest, related permissions and APIs
Extensions / Manifest V3
Manifest V3 Manifest V3 is the latest version of the extensions platform. We have made a number of changes to the available APIs and added a number of new features. Manifest V3 aims to be the first step in our platform vision to improve the privacy,
chrome.webstore
As of 06/12/2018, inline installation is deprecated. For more information, read our Chromium Blog post and Migration FAQ.
User interface components
A catalog of user interface elements available in extensions.
Prepare your extension
Prepare your extension files.
Set up your developer account
How to set up your Chrome Web Store developer account.
Support and feedback
Give us feedback to help us improve the platform and fix its bugs.
Submit a feature request
Submit a request for a feature that you believe could improve the extension platform.
Storage and cookies
Overview of how web storage APIs and cookies work in extensions.
Use your Google Analytics account with the Chrome Web Store
See analytics for your Chrome Web Store listing in addition to the metrics offered in the Developer Dashboard.
Design a superior user experience with the new Side Panel API
Introducing the new Side Panel API for Chrome extensions.
Manifest V3 migration checklist
A quick reference for upgrading your extensions from Manifest V2 to Manifest V3.
Test service worker termination with Puppeteer
A guide explaining how to test service worker termination using Puppeteer.
Affiliate Ads FAQ
Frequently asked questions about Chrome Web Store's policies on affiliate ads.
Affiliate Ads
Any affiliate program must be described prominently in the product's Chrome Web Store page, user interface, and before installation. Related user action is required before the inclusion of each affiliate code, link, or cookie. Some example violations
Chrome Extensions: Extending API to support Instant Navigation
The Extensions API has been updated to support back/forward cache, preloading navigations.
Handling Requirements
If your product is associated with a security vulnerability that could be exploited to compromise another application, service, browser, or system, we may remove your product from the Chrome Web Store and take other measures to protect users. In such
Accepting Payment From Users
If you collect sensitive personal information through your Product for sales, you must follow these requirements: You must securely collect, store, and transmit all credit card and other sensitive personal information in accordance with privacy and
Ads
Ads are considered part of your Product for purposes of content review and compliance with developer terms, and therefore must comply with the above content policies. Ads which are inconsistent with the content rating of your products or extension
Regulated goods and services
Don't engage in or promote unlawful activities in your product, such as rape, illegal sex work, or the sale of prescription drugs without a prescription. We will remove content which promotes, glorifies, or encourages dangerous or illegal activity
Use of Permissions
Request access to the narrowest permissions necessary to implement your Product's features or services. If more than one permission could be used to implement a feature, you must request those with the least access to data or functionality. Don't
Impersonation & Intellectual Property
Don't pretend to be someone else, and don't represent that your product is authorized by, endorsed by, or produced by another company or organization, if that is not the case. Your Product and its user experience also must not mimic functionality or
API Use
Extensions must use existing Chrome APIs for their designated use case. Use of any other method, for which an API exists, would be considered a violation. For example, overriding the Chrome New Tab Page through any means other than the URL Overrides
Malicious and Prohibited Products
Don't transmit viruses, worms, defects, Trojan horses, malware, or any other products of a destructive nature. We don't allow content that harms or interferes with the operation of the networks, servers, or other infrastructure of Google or any
Enforcement Circumvention
Any attempt to circumvent intended limitations or enforcement actions will result in the immediate termination of your developer account, and possibly related developer accounts.
Limited Use
This policy establishes the Chrome Web Store's minimum user data privacy requirements; you or your Product must comply with applicable laws. You must limit your use of the data to the practices you disclosed. Collection and use of web browsing
Minimum Functionality
Do not post an extension with a single purpose of installing or launching another app, theme, webpage, or extension. Extensions with broken functionality—such as dead sites or non-functioning features—are not allowed. Extensions must provide a basic
Spam and Abuse
We don't allow any developer, related developer accounts, or their affiliates to submit multiple extensions that provide duplicate experiences or functionality on the Chrome Web Store. Extensions should provide value to users through the creation of
Disclosure Requirements
You must be transparent in how you handle user data (e.g., information provided by a user or collected about a user or a user's use of the Product or Chrome Browser), including by disclosing the collection, use, and sharing of the data. If your
Chrome Apps
To ensure a great user experience, Chrome Apps distributed through the Chrome Web Store must follow the additional quality guidelines listed below. The guidelines in this section apply only to Chrome Apps. Packaged apps should: Take advantage of the
Privacy Policies
If your Product handles any user data, then you must post an accurate and up to date privacy policy. The privacy policy must, together with any in-Product disclosures, comprehensively disclose: How your Product collects, uses and shares user data All
Notification and appeals
In the event that your Product is removed from the Chrome Web Store, you will receive an email notification to that effect, with further instructions if applicable. Verify that the associated publisher account with your Product can receive emails
Repeat Abuse
Serious or repeated violations of the Chrome Web Store Distribution Agreement or these Program Policies will result in the suspension of your developer account, and possibly related developer accounts. Additionally, you may be banned from using the
2-Step Verification
To ensure the security of Chrome Web Store accounts, 2-Step Verification is required for all developer accounts prior to publishing an extension or updating an existing extension. Developers can activate 2-Step Verification for their Google accounts
Misleading or Unexpected Behavior
We do not allow products that deceive or mislead users, including in the content, title, description, or screenshots. If any of your product's content, title, icon, description, or screenshots contains false or misleading information, we may remove
Hate Speech and Violent Behavior
Depictions of gratuitous violence are not allowed. Products should not contain materials that threaten, harass, or bully other users. We don't allow content or products that advocating against or inciting hatred towards groups of people based on
Code Readability Requirements
Developers must not obfuscate code or conceal functionality of their extension. This also applies to any external code or resource fetched by the extension package. Minification is allowed, including the following forms: Removal of whitespace,
Featured Products
The Chrome Web Store features products that align with our standards, values, and that we believe will produce valuable user experiences. Certain products that don't meet these standards, but which do not explicitly violate Chrome Web Store
Known issues when migrating to Manifest V3
Recently, we announced changes to the Manifest V2 deprecation timeline, and while we remain firmly committed to Manifest V3 we acknowledge there is more work to do on our part. We are committed to closing the following gaps before announcing a new
Discovery on the Chrome Web Store
An overview of how users find items on the Chrome Web Store, and how our editors select items to feature.
Chrome Web Store review process
An overview of the review process and how enforcement actions result from detected policy violations.
Manifest V2 support timeline
Details of the Manifest V2 phase-out and end of life.
Check on your review status
How to check the review status of your Chrome Web Store item.
Analyze your store listing metrics
Understanding metrics and performance of your Chrome Web Store store listing.
Manage user feedback
Follow-up on reviews and provide user support in the Chrome Web Store.
Cross-origin isolation
Overview of cross-origin isolation for extensions
Enterprise publishing options
How to distribute extensions to enterprise users
Extension actions in Manifest V3
Chrome extensions had Browser and Page Actions APIs for years, but Manifest V3 replaced both with a generic Actions API. This post explores the history of these APIs and what has changed in Manifest V3.
Introducing chrome.scripting
The Scripting API is a new Manifest V3 API focused on, well, scripting. Let's dig into the motivations for this change and how it's different.
Extension Manifest Converter
Open source tool to convert extensions to Manifest V3. You'll still need to manually update any code with non-mechanical changes, such as adapting to use service workers or some script injection.
Web Accessible Resources for Manifest V3
Web Accessible Resources for Manifest V3 is here! Now `manifest.json` supports permission definitions. Developers can restrict resources based on the requesting site origin or extension id.
Complete your listing information
How to add listing information for your Chrome Web Store item.
Prepare to publish: set up payment and distribution
How to choose which countries will list your item and who will see it in the Chrome Web Store.
Update your Chrome Web Store item
How to update an extension or theme ("item") that you previously published on the Chrome Web Store.
Troubleshooting Chrome Web Store violations
Guidelines for understanding why an item was rejected or removed from the Chrome Web Store and how to fix the problem.
Chrome Web Store payments deprecation
Why the payments is deprecated, details about the deprecation timeline, and more.
Deleting Chrome Web Store developer accounts
How to delete a developer or group publisher account on the Chrome Web Store.
Set up a group publisher
How to share ownership of your Chrome Web Store items with other developers.
Fill out the privacy fields
Use the privacy practices tab to help the Chrome Web Store team review your extension as quickly as possible.
Spam policy FAQ
Frequently asked questions about Chrome Web Store's spam policy.
Supplying Images
Guidelines about the kinds of images you need to supply to the Chrome Web Store.
Branding Guidelines
Guidelines for use of Google trademarks.
Best Practices
How to create a high-quality extension and Chrome Web store listing.
Trader FAQ: Chrome Web Store
Frequently asked questions about Chrome Web Store's user data policy.
Updated Privacy Policy & Secure Handling Requirements
Frequently asked questions about Chrome Web Store's user data policy.
Media Source Extensions for Audio
Media Source Extensions (MSE) provide extended buffering and playback control for the HTML5 audio and video elements. While originally developed to facilitate Dynamic Adaptive Streaming over HTTP (DASH) based video players, MSE can be used for audio; specifically for gapless playback.
What is the Chrome Web Store?
An explanation of the Chrome Web Store and why you might want to use it.
Publish in the Chrome Web Store
How to publish a new extension or theme to the Chrome Web Store.
Google Chrome Web Store Developer Agreement
The legal agreement governing the relationship between Chrome Web Store developers and the Chrome Web Store.
Content Ratings Guidelines
Guidelines about how the Chrome Web Store rates the maturity of content.
Localization message formats
Reference documentation about the format of the messages.json file for Chrome Extensions.