Skip to content

Latest commit

 

History

History
43 lines (29 loc) · 2.07 KB

index.md

File metadata and controls

43 lines (29 loc) · 2.07 KB
Raw
title slug
API
Mozilla/Add-ons/WebExtensions/API

{{AddonSidebar}}

WebExtension JavaScript API 可以在附加组件的后台脚本和附加组件定义的任何浏览器动作或页面动作中使用。这里的部分 API 也可以通过附加组件的内容脚本访问（见内容脚本指南列表）。

要使用更强大的 API，你需要在你的 manifest.json 中申请权限。

你可以使用 browser 命名空间访问这些 API。

function logTabs(tabs) {
  console.log(tabs);
}

browser.tabs.query({ currentWindow: true }, logTabs);

许多 API 为异步，返回一个 Promise：

function logCookie(c) {
  console.log(c);
}

function logError(e) {
  console.error(e);
}

var setCookie = browser.cookies.set({ url: "https://developer.mozilla.org/" });
setCookie.then(logCookie, logError);

请注意，这不同于 Google Chrome 的扩展系统，它使用 chrome 而非 browser 名字空间，并且对异步函数使用回调而不是 promises。为辅助移植，Firefox 实现的 WebExtensions 支持 chrome 和回调以及 browser 和 promises。Mozilla 也写了一个 polyfill 使使用 browser 和 promises 的代码能不经修改的在 Chrome 中使用：https://github.com/mozilla/webextension-polyfill。

微软 Edge 使用 browser 名字空间，但尚不支持基于 promise 的异步 API。目前在 Edge 中，异步 API 必须使用回调。

并非所有浏览器都支持这里的所有 API：详情见浏览器对 JavaScript API 的支持。

{{SubpagesWithSummaries}}