Microsoft Edge 擴充功能使用了 Chromium 瀏覽器引擎平台的 JavaScript 方法子集。 在為 Microsoft Edge 瀏覽器建立擴充功能時,您可以使用以下 API。
| API | 描述 | 清單版本 | 平台 |
|---|---|---|---|
| 無障礙功能 | 管理瀏覽器的無障礙功能。 | MV2,MV3 | Windows、Linux、Mac |
| action | 控制瀏覽器工具列中擴充功能的圖示。 | MV3 | Windows、Linux、Mac、Android |
| 警報 | 排程程式在未來特定時間或定期執行。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 書籤 | 建立、整理並操作書籤。 | MV2,MV3 | Windows、Linux、Mac |
| browserAction | 在 Microsoft Edge 的工具列中使用瀏覽器動作放置圖示。 你也可以用瀏覽器操作新增提示、徽章或彈出視窗。 | MV2 | Windows、Linux、Mac、Android |
| 瀏覽資料 | 移除使用者本機個人資料中的瀏覽資料。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 指令 | 新增鍵盤捷徑,觸發擴充功能中的動作,例如開啟瀏覽器或向擴充功能發送指令。 | MV2,MV3 | Windows、Linux、Mac |
| 內容設定 | 自訂 Microsoft Edge 在每個站點的行為,而非全域。 變更設定,控制網站是否能使用 Cookie、JavaScript 及外掛等功能。 | MV2,MV3 | Windows、Linux、Mac、Android |
| context 選單 | 在 Edge) (右鍵選單新增項目Microsoft Edge。 選單項目可以套用到不同的物件,例如圖片、超連結和頁面。 | MV2,MV3 | Windows、Linux、Mac |
| 䴺 | 查詢並修改 Cookie,並在 Cookie 變更時收到通知。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 除錯器 | 可附加於一個或多個分頁以進行儀器網路互動、除錯 JavaScript、變更 DOM、變更 CSS 等功能。 使用 Debuggee tabId 來鎖定帶有 sendCommand的分頁,並從回調中路由事件tabIdonEvent。 |
MV2,MV3 | Windows、Linux、Mac |
| 宣告性內容 | 根據頁面內容執行動作,無需授權即可閱讀該頁面內容。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 宣告式NetRequest | 透過指定宣告式規則來阻擋或修改網路請求,提供更多隱私。 允許擴充功能修改網路請求,而不會攔截請求並查看內容。 | MV2,MV3 | Windows、Linux、Mac、Android |
| desktopCapture | 擷取螢幕、單一視窗或分頁的內容。 | MV2,MV3 | Windows、Linux、Mac |
| devtools.inspectedWindow | 與被檢查的窗戶互動。 例如,取得頁面的分頁 ID、評估程式碼、刷新頁面,或取得頁面上的資源。 | MV2,MV3 | Windows、Linux、Mac |
| DevTools.network | 擷取 DevTools 網路 工具所顯示的網路請求資訊。 | MV2,MV3 | Windows、Linux、Mac |
| DevTools.panels | 透過建立自己的面板、存取現有面板或新增側邊欄,將你的擴充功能整合進開發者工具視窗的介面中。 | MV2,MV3 | Windows、Linux、Mac |
| DNS | 解析 DNS 位址。 | MV2,MV3。 開發者頻道。 | Windows、Linux、Mac |
| DOM | 存取用於擴充功能的特殊 DOM API。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 下載 | 程式化啟動、監控、操作並搜尋下載。 | MV2,MV3 | Windows、Linux、Mac、Android |
| enterprise.hardwarePlatform | 取得瀏覽器所運行硬體平台的製造商與型號。 對於由企業政策安裝的擴充功能。 | MV2,MV3 | Windows、Linux、Mac |
| 活動 | API常見的類型,這些API會用來在有趣事件發生時通知你。 | MV2,MV3 | Windows、Linux、Mac |
| 延伸 | 任何擴充頁面都能使用的工具。 包含擴充功能與其內容腳本之間,或擴充功能間交換訊息的支援。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 擴展類型 | Microsoft Edge 擴充的類型宣告。 | MV2,MV3 | Windows、Linux、Mac |
| font設定 | 管理 Microsoft Edge 的字型設定。 | MV2,MV3 | Windows、Linux、Mac |
| 史 | 與瀏覽器瀏覽頁面的紀錄互動。 你可以新增、移除或查詢瀏覽器歷史紀錄中的網址。 若要用你自己的版本覆蓋歷史頁面,請前往覆寫頁面。 | MV2,MV3 | Windows、Linux、Mac、Android |
| i18n | 在整個應用程式或擴充功能中實施國際化。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 身份 | 會獲得 OAuth2 存取權杖。 不支援: identity.getAccounts、 identity.getAuthToken - 作為替代方案,你可以使用 identity.launchWebAuthFlow 取得 OAuth2 令牌來驗證使用者。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 怠 | 偵測機器閒置狀態何時改變。 | MV2,MV3 | Windows、Linux、Mac、Android |
| input.ime | 為作業系統實作自訂的 IME,允許擴充功能處理按鍵、設定組合及管理候選視窗。 | MV2,MV3 | Windows、Linux、Mac |
| 管理 | 管理已安裝或正在執行的擴充功能清單。 可以覆寫內建的新分頁頁面。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 通知 | 利用範本建立豐富的通知,並顯示在系統托盤中。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 幕外 | 建立並管理螢幕外的文件。 | MV3 | Windows、Linux、Mac、Android |
| 全能盒 | 在 Microsoft Edge 地址列(也稱為全能盒)登錄關鍵字。 | MV2,MV3 | Windows、Linux、Mac |
| pageAction | 在 Microsoft Edge 工具列中,地址列右側新增圖示。 頁面動作是指可以在當前頁面上執行的動作,並不適用於所有頁面。 頁面動作在非啟用時會顯示灰色。 | MV2 | Windows、Linux、Mac、Android |
| pageCapture | 分頁會儲存為 MHTML 檔案。 | MV2,MV3 | Windows、Linux、Mac |
| 權限 | 檢索要宣告,執行時可選權限,而非安裝時。 你可以利用這個 API 向使用者顯示所需且已核准的權限。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 力 | 覆蓋系統的電源管理功能。 | MV2,MV3 | Windows、Linux、Mac |
| printerProvider | 利用事件查詢印表機、其功能,並提交列印工作。 | MV2,MV3 | Windows、Linux、Mac |
| 隱私 | 控制影響使用者隱私的 Microsoft Edge 功能。 此 API 依賴EdgeSettingtypes原型來取得並設定 Microsoft Edge 的設定。 |
MV2,MV3 | Windows、Linux、Mac |
| 流程 | 與瀏覽器的程序互動。 | MV2,MV3。 開發者頻道。 | Windows、Linux、Mac |
| 代理 | 管理 Microsoft Edge 的代理設定。 這個 API 依賴 EdgeSetting 於 API 的原型 types 來取得並設定 Microsoft Edge 的代理設定。 |
MV2,MV3 | Windows、Linux、Mac |
| 運行時間 | 擷取背景頁面,回傳清單細節,並監聽及回應應用程式或擴充生命週期中的事件。 你也可以將 URL 的相對路徑轉換成完全限定的 URL。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 腳本編寫 | 在不同情境下執行腳本。 | MV3 | Windows、Linux、Mac、Android |
| 尋 | 透過預設服務提供者進行搜尋。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 錄音 | 查詢並還原瀏覽時的分頁和視窗。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 側面板 | 在瀏覽器側邊欄中,與網頁的主要內容並列,並存自訂內容。 請參見 Microsoft Edge 側邊欄的「開發擴充功能」。 | MV3 | Windows、Linux、Mac |
| 倉庫 | 儲存、檢索並追蹤使用者資料的變更。 | MV2,MV3 | Windows、Linux、Mac、Android |
| System.cpu | 查詢 CPU 元資料。 | MV2,MV3 | Windows、Linux、Mac、Android |
| system.display | 查詢會顯示元資料。 | MV2,MV3 | Windows、Linux、Mac |
| system.memory | 報告可用記憶體容量及總物理記憶體容量。 | MV2,MV3 | Windows、Linux、Mac、Android |
| system.storage | 查詢儲存裝置資訊。 你也可以在儲存裝置連接或分離時收到通知。 | MV2,MV3 | Windows、Linux、Mac |
| tabCapture | 與分頁媒體串流互動。 | MV2,MV3 | Windows、Linux、Mac |
| tabGroups | 與瀏覽器的分頁分組系統互動。 修改並重新排列瀏覽器中的分頁群組。 若要分組與取消分組,或查詢哪些分頁屬於群組,請改用 分頁 API。 | MV3 | Windows、Linux、Mac |
| 標籤 | 與瀏覽器的分頁系統互動,以建立、修改及重新排列分頁。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 頂尖網站 | 存取顯示在新分頁頁面上的熱門網站,也稱為 最受訪網站。 這些網站沒有用戶自訂的捷徑。 | MV2,MV3 | Windows、Linux、Mac |
| TTS | 播放合成文字轉語音 (TTS) 。 | MV2,MV3 | Windows、Linux、Mac |
| ttsEngine | 實作文字轉語音 (TTS) 引擎,並使用擴充功能。 註冊使用此 API 的擴充功能會接收包含要說出的語句及其他參數的事件。 擴充功能接著可以使用任何可用的網路技術來合成並輸出語音,並將事件回傳給呼叫函式以回報狀態。 | MV2,MV3 | Windows、Linux、Mac |
| 類型 | Microsoft Edge 的 type 聲明。 | MV2,MV3 | Windows、Linux、Mac |
| 使用者腳本 | 在使用者腳本上下文中執行使用者腳本。 | MV3 | Windows、Linux、Mac、Android |
| webAuthenticationProxy | 讓遠端桌面軟體在遠端主機上執行,攔截 Web Authentication API (WebAuthn) 請求,以便在本地用戶端處理。 | MV3 | Windows、Linux、Mac |
| 網路導航 | 接收導航請求狀態的通知。 | MV2,MV3 | Windows、Linux、Mac、Android |
| webRequest | 觀察並分析交通狀況。 攔截、阻擋或修改請求。 | MV2,MV3 | Windows、Linux、Mac、Android |
| 窗戶 | 與瀏覽器視窗互動,以建立、修改及重新排列瀏覽器中的視窗。 | MV2,MV3 | Windows、Linux、Mac |
不支援的 API
這些擴充 API 不支援 Microsoft Edge。
| API | 附註 |
|---|---|
| 音效 | 只限 ChromeOS。 |
| certificateProvider | 只限 ChromeOS。 |
| DevTools.recorder | 僅限 Chrome DevTools 使用。 |
| 文件掃描 | 只限 ChromeOS。 |
| enterprise.deviceAttributes | 只限 ChromeOS。 |
| enterprise.networking屬性 | 只限 ChromeOS。 |
| enterprise.platform鍵 | 只限 ChromeOS。 |
| 檔案瀏覽器處理程序 | 只限 ChromeOS。 |
| fileSystemProvider | 只限 ChromeOS。 |
| GCM | |
| identity.getAccounts | |
| identity.getAuthToken | 利用 OAuth2 的 oauth2 區段 manifest.json中指定的客戶端 ID 和範圍,取得 OAuth2 存取權杖。 作為替代方案,你可以使用 identity.launchWebAuthFlow 取得 OAuth2 令牌來驗證使用者。 |
| instanceID | |
| loginState | 只限 ChromeOS。 |
| 平台鍵 | 只限 ChromeOS。 |
| 印刷術 | 只限 ChromeOS。 |
| 列印度量 | 只限 ChromeOS。 |
| 閱讀清單 | |
| vpnProvider | 只限 ChromeOS。 |
| 壁紙 | 只限 ChromeOS。 |
支援 API 的額外考量
使用者必須使用Microsoft Microsoft帳號 (MSA) 或Microsoft Entra ID帳號
chrome.identity.getProfileUserInfo登入 Edge 。 如果使用者使用本地的 Microsoft Entra ID 帳號登入 Microsoft Edge,API 會回傳null電子郵件和 ID 的值。Microsoft帳戶 (MSA) 是 Outlook.com、Live.com 或 Hotmail.com 帳戶。
Microsoft Edge 不支援使用 Chrome 網路商店付款的擴充功能,因為它會向
identity.getAuthtoken登入用戶請求代幣。 這些憑證會被傳送到基於 REST 的授權 API。
注意事項
本頁部分內容基於 Google 創作與 分享 的作品,並依 據創用CC 姓名標示 4.0 國際授權條款進行修改。 原始頁面 可在此查閱。
本作品採用 創用CC 姓名標示4.0國際授權條款授權。