@equinor/echo-base

中文文档
7.0.0发布于 2026/10/27MITTypeScriptCommonJS近 30 天下载 2698

logo

中文使用文档
文档目录3 节
  1. 扶养规则
  2. 如何开发并发布 EchoCore
  3. 可用的国家预防机制脚本

logo

回声基

Echo网络需要微前端开发.

这个库是用 无。 。 。 .

扶养规则

真相来源: /eslint.config.js - 那个 @nx/enforce-module-boundaries 规则定义所有允许的依赖.

回声基是基础库,CANNOT从任何其他回声库导入.

见 libs/README.md 用于完整依赖性流程图.


如何开发并发布 EchoCore

检查 读取我 在 NX 库文件夹中.

可用的国家预防机制脚本

  • lint-base
  • build-base
  • test-base

有什么新情况

v. 7.0 计:

  • 已移动到 Monorepo
  • 更新了一些 Typescription 类型 : 它们使用 Monorepo 设置导致构建错误

v. 6.0 计:

  • 固定错误报告到应用程序的洞察力,它现在正确地报告包括内在ErrorsProperties在内的所有属性.
  • 固定 baseError,它现在恰当地支持了巢内核. 例外/ 内置出错 .
  • BaseError 现在有错误 TraceId, 或来自后端, 或独有的前端 ID
  • BaseError 为获取属性或属性而添加的帮助方法ByName

建议创建您自己的错误类型, 扩展 BaseError, 用您自己的字段来装饰它 :

    export class PdfError extends BaseError {
        docNo: string;
        constructor(args: { message: string; docNo: string; innerError?: Error }) {
            super({ name: 'PdfError', message: args.message, innerError: args.innerError });
            this.docNo = args.docNo;
        }
    }

中断更改

v. 6.0 计:

  • 已重命名 initializeError 改为 initializeNetworkError 并简化它。 现在只需要 NetworkErrorArgs 作为争论.
  • BaseError 现在用参数正确支持嵌入(和嵌入-消除)错误 innerError。 。 。 .
    早先的同名属性会互相覆盖.
    exception 参数重命名为 innerError类型 Record<string, unknown> | Error
  • BaseError 不再直接将属性添加到自身,而是使用带参数的嵌入错误 innerError。 。 。 .
  • 改为 BaseError.allProperties()["someCustomProperty"] 使用情况 BaseError.findPropertyByName("someCustomProperty")。自从我们现在使用 innerError 类型 Error 或记录 < 字符串, 未知>, 该属性已从 BaseError [财产] 移动到 baseError. innerError [财产].
  • 移动 EchoEvents 符号为 EchoCore。 。 。 .
  • 更改类型 EventHub 所有函数中的事件按键来自 string | EchoEvents 改为 string 只有这个.

v.0.5.0: (中文(简体) )

  • BaseError的子分类将不再自动获得类名,而必须指定. 这是为了避免名称被混淆/忽略为appInsight中的单个字母.

实施实例:

export class CustomError extends BaseError {
    constructor(args: ErrorArgs) {
        super({ ...args, name: 'CustomError' });
    }
}

版本与发布记录

@equinor/echo-base 共发布 126 个版本,首次发布于 2021/04/12;过去 12 个月发布了 33 个版本。

版本发布日期距今
7.0.0latest2026/10/2717 天前
7.0.0-beta-2beta2026/10/2717 天前
7.0.0-beta-12026/10/2222 天前
7.0.0-beta-02026/10/2024 天前
6.3.12026/08/073 个月前
6.3.02026/07/233 个月前

其他发布通道:next → 0.6.13-rc1,beta → 7.0.0-beta-2。

关于 @equinor/echo-base 的常见问题

如何安装 @equinor/echo-base?

在项目目录运行 npm install @equinor/echo-base,或使用 pnpm add / yarn add / bun add。

@equinor/echo-base 支持 TypeScript 吗?

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

@equinor/echo-base 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@equinor/echo-base 可以商用吗?

@equinor/echo-base 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@equinor/echo-base 的下载量有多少?

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

@equinor/echo-base 还在维护吗?

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