@exceptionless/core

中文文档
3.2.1发布于 2026/06/11Apache-2.0TypeScriptES Module零依赖构建来源已验证近 30 天下载 3134

JavaScript 无例外客户端

中文使用文档
文档目录4 节
  1. 开始
  2. 安装
  3. 配置
  4. 支助

无例外客户端 SDK

此套件包含所有其他 JS 客户端的默认执行 继续前进。 你可以直接使用,但我们建议使用其中一个包 在下面自动连接到特定错误处理器和 平台特定插件.

开始

要使用这个软件包,您必须使用ES6,并支持无害环境管理模块.

安装

npm install @exceptionless/core --save

配置

你的应用开始的时候 你应该打电话 startup 在无例外的情况下 客户端。 确保客户端配置和自动抓取 未处理错误发生 .

import { Exceptionless } from "@exceptionless/core";

await Exceptionless.startup((c) => {
  c.apiKey = "API_KEY_HERE";
  c.setUserIdentity("12345678", "Blake");

  // set some default data
  c.defaultData["mydata"] = {
    myGreeting: "Hello World"
  };

  c.defaultTags.push("Example", "JavaScript");
});

完成后,可以在应用程序的任何地方使用无例外客户端 导入 Exceptionless 之后是您想要使用的方法。 例如:

await Exceptionless.submitLog("Hello world!");

请看 文档 页:1 关于客户端配置的更多信息.

支助

如果您需要帮助,请联系我们 通过内部支持, 打开一个问题 或者说 加入我们在 Discord 上的聊天我们总是在这里 有问题就帮忙!

版本与发布记录

@exceptionless/core 共发布 18 个版本,首次发布于 2021/06/09;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.2.1latest2026/06/115 个月前
3.2.02026/06/115 个月前
3.1.02024/03/292 年前
3.0.52023/10/243 年前
3.0.42023/09/273 年前
3.0.32023/09/093 年前

关于 @exceptionless/core 的常见问题

@exceptionless/core 是什么?

JavaScript 无例外客户端

如何安装 @exceptionless/core?

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

@exceptionless/core 支持 TypeScript 吗?

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

@exceptionless/core 支持 ESM 还是 CommonJS?

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

@exceptionless/core 可以商用吗?

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

@exceptionless/core 的下载量有多少?

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

@exceptionless/core 还在维护吗?

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