@haatlabs-core/extension-kit

中文文档
0.18.5发布于 2026/11/14Apache-2.0TypeScriptES Module近 30 天下载 4737

扩展面板的浏览器侧:活动标签,页面读取,下载,登录密钥.

中文使用文档

@haatlabs-core/extension-kit (英语)

扩展面板(Manifest V3)的浏览器侧面: PanelEnv 联 合 国 @haatlabs-core/extension-ui chrome 或 Edge 侧面面板, 服务工人的设置,以及 键,一个应用程序自己的连接页面负责该扩展名.

安装

pnpm add @haatlabs-core/extension-kit

使用

  • createChromePanelEnv(): 活动标签(一旦点击该图标,或 允许每个站点),面板自身窗口中的标签更改,下载(一个文件按部件制作) jSON从页面内读取,并按页面的脚本 与全球.
  • openSidePanelOnIconClick(),在服务工作者中:工具栏图标打开侧面板.
  • 通过应用程序自己的连接页面登录: startConnect(webOrigin) 打开 <webOrigin>/connect/extension?extension=<id>· ; listenForConnections({ <app>: <webOrigin> }) 在服务人员中保存页面发送的密钥(<app>.connected),只从此 来源; createAuthStore(app) 在本地存储中读取、保存和忘记(从未同步).

对于一个带有自己后端的应用程序的扩展(不是在平台上所建):

  • fillFields(tabId, [{ selector, value }]) 填入页面的表格 在页面自己的世界,所以 反应和 Vue 表格保留值(a) <select> ,并返回 { filled, missing }:显示缺失的东西,永远不要跳过. copyText(text) 副本.
  • SiteAdapter: 一个站点作为数据的形式(matches 作为克罗梅匹配模式 anchor 字段,以及 fields(data, page)(三); matchAdapter(url, adapters) 选取一页.
  • installFillButton({ adapters, label, onFill }),在内容脚本中:在 形式的第一个字段.
  • startOAuthPkce({ authorizeUrl, tokenUrl, clientId, scopes }) 输入 chrome.identity 与OAuth 2和PCE(S256, state 返回 { accessToken, refreshToken, expiresAt }· ; refreshOAuth(grant, tokenUrl, clientId) 续约 在最后一分钟. createAuthStore 保留任何一种赠款.

Chrome, Edge, Firefox 和 Safari 从一个代码基础:

  • browserName() (单位:千美元)chromium, (中文(简体) ), firefox, (中文(简体) ), safari)和 extensionApi() (单位:千美元)browser 这里 是一个,另一个 chrome) (中文(简体) ). createChromePanelEnv firefox 和 Safari 的答案 chrome.* 我也一样.
  • openPanelOnIconClick()在背景脚本中:Chrimium的侧面板,Firefox的侧边栏; 在Safari上,面板是动作的弹出.
  • manifestFor(browser, base, { geckoId }) 从一个铬写出每个浏览器的列表 基础: Firefox 得到 sidebar_action,背景脚本和 browser_specific_settings· ; Safari 弹出和否 identity 允许.
  • startOAuthPkce 输入 chrome.identity 或者说 browser.identity在那座乐园里 无,通过标签到应用程序自己的页面(safariRedirectUri),将答案递回 与 browser.runtime.sendMessage。 。 。 .

明显需要的是 sidePanel, (中文(简体) ), scripting, (中文(简体) ), downloads, (中文(简体) ), storage 财务报告和审定财务报表 activeTab 权限, optional_host_permissions: ["https://*/*"],且该应用的网页来源于 externally_connectable。 。 。 .

该软件包仅供浏览器使用:其代码在扩展中运行,通过捆绑.

版本与发布记录

@haatlabs-core/extension-kit 共发布 27 个版本,首次发布于 2026/10/23;过去 12 个月发布了 27 个版本。

版本发布日期距今
0.18.5latest2026/11/144 天前
0.18.42026/11/134 天前
0.18.32026/11/134 天前
0.18.22026/11/134 天前
0.18.12026/11/134 天前
0.18.02026/11/134 天前

关于 @haatlabs-core/extension-kit 的常见问题

@haatlabs-core/extension-kit 是什么?

扩展面板的浏览器侧:活动标签,页面读取,下载,登录密钥.

如何安装 @haatlabs-core/extension-kit?

在项目目录运行 npm install @haatlabs-core/extension-kit,或使用 pnpm add / yarn add / bun add。

@haatlabs-core/extension-kit 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@haatlabs-core/extension-kit 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@haatlabs-core/extension-kit 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@haatlabs-core/extension-kit 可以商用吗?

@haatlabs-core/extension-kit 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@haatlabs-core/extension-kit 的下载量有多少?

根据 npm 官方下载统计,@haatlabs-core/extension-kit 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,737 次,日均约 158 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@haatlabs-core/extension-kit 还在维护吗?

最新版本 0.18.5 发布于 2026/11/14(4 天前);至今共发布 27 个版本,其中过去 12 个月发布了 27 个;首次发布于 2026/10/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。