按平台安装

任意网站

安装 npm install @blipit/browser

Blipit 浏览器 SDK 只有 7 KB。它捕获未捕获的错误、未处理的 promise rejection 和失败的请求，保留导致每个错误的点击和请求，记录 Web 指标，并能在错误发生时录制会话回放。在打包应用中从 npm 安装，或在任意页面中放一个 script 标签。

1使用 npm

在其余代码运行之前调用一次 init。使用公钥。

sh
npm install @blipit/browser
js
import * as Blipit from "@blipit/browser";

Blipit.init({
  key: "<public key>",
  environment: "production",
  release: "2026.09.28",
  replay: { onErrorSampleRate: 1 },
});

2不用打包器：一个 script 标签

将其粘贴到每个页面的 <head> 中，或粘贴到你的平台的自定义代码位置。

html
<script src="https://blipit.io/sdk/blipit.js"></script>
<script>
  Blipit.init({ key: "<public key>", environment: "production", release: "2026.09.28", replay: { onErrorSampleRate: 1 } });
</script>

3告诉 Blipit 用户是谁（可选）

登录后附加用户信息，问题就能显示受影响的人，回放也可以按用户查找。

js
Blipit.setUser({ id: "42", email: "ana@example.com" });

4验证是否生效

在你网站的浏览器控制台中运行下面这行。打开 app.blipit.io 中的“问题”。首个事件几秒钟内就会出现，并归组为一个问题，负责人会收到邮件。

js
Blipit.captureMessage("Hello from " + location.host, "info");

须知

  • 选项：sampleRate（0 到 1）、ignoreErrors（字符串或正则）、beforeSend 用于丢弃或修改事件、maxBreadcrumbs、webVitals（默认开启）、autoSessionTracking 用于无崩溃率（需要 release）。
  • 如果你想控制升级，固定版本的脚本位于 blipit.io/sdk/0.2.0/blipit.js。
  • Content Security Policy：在 connect-src 中允许 https://in.blipit.io；如果使用 script 标签，还需在 script-src 中允许 https://blipit.io。
  • 已经在浏览器中使用 Sentry SDK？无需更改即可使用：将 DSN 设为 https://<public key>@in.blipit.io/<project id>。

遇到问题？发邮件至 support@blipit.io。每个项目的密钥和确切的 DSN 在 app.blipit.io 的“API 密钥”下。