轻量级状态事件总线 eventbusx-js 开源使用教程

文章目录

- [轻量级状态事件总线 eventbusx-js 开源使用教程](#轻量级状态事件总线 eventbusx-js 开源使用教程)

文章简介

一款极简无依赖的 JS 状态事件总线工具，采用发射器+接收器经典设计模式，专门用于监听数据状态、自动生成事件消息、统一分发业务逻辑，语法简洁，上手零难度，Node.js与浏览器环境均可直接使用。

基本信息

开源作者：董翔

开发年份：2026

开源协议：MIT

NPM官方地址：https://www.npmjs.com/package/eventbusx-js

核心设计思想

轻量级事件总线，由发射器监听数据状态并生成对应消息，接收器统一接收消息并分发处理自定义业务逻辑，结构分层清晰，代码易维护，非常适配状态轮询、数值监测、条件触发等开发场景。

核心两大模块

Emitter 事件发射器
绑定监听数据源，自定义状态判断规则，根据数据状态自动拼接生成事件提示消息。
Acceptor 事件接收器
接收发射器传出的事件消息，统一回调执行开发者自定义业务处理逻辑。

安装方式

bash 复制代码

npm install eventbusx-js

完整使用示例

javascript 复制代码

const EventBus = require('eventbusx-js');

// 定义监听数据源
let num = 0;
const target = { value: num };

// 实例化发射器与接收器
const numEmitter = new EventBus.Emitter(target);
const msgAcceptor = new EventBus.Acceptor();

// 状态检测核心方法
function checkTask() {
    // 设置基础事件提示文本
    numEmitter.setBaseMsg("overflow");
    // 自定义状态监听判断规则
    numEmitter.watch((t) => {
        return t.value >= 5;
    });
    // 接收器接收消息并执行业务逻辑
    msgAcceptor.run(numEmitter.execute(), (msg) => {
        if (msg === "overflow") {
            console.log("msg: " + msg + " [超限] 数值达标 → 执行逻辑");
        } else {
            target.value++;
            console.log("msg: " + msg + " [正常] 运行中");
        }
    });
    console.log("当前值：" + target.value + "\n");
}

// 模拟循环轮询检测
for (let i = 0; i < 6; i++) {
    checkTask();
}

程序运行输出结果

复制代码

msg: overflow! [正常] 运行中
当前值：1

msg: overflow! [正常] 运行中
当前值：2

msg: overflow! [正常] 运行中
当前值：3

msg: overflow! [正常] 运行中
当前值：4

msg: overflow! [正常] 运行中
当前值：5

msg: overflow [超限] 数值达标 → 执行逻辑
当前值：5

适用开发场景

项目内数值上下限实时监测
设备运行状态轮询监听
满足指定条件自动触发业务流程
轻量化状态机简易实现
前后端简易消息状态分发

项目优势

零第三方依赖，体积小巧不冗余
架构极简，无多余API，纯原生JS编写
数据源与业务逻辑完全解耦
跨环境通用，Node端、浏览器端均可运行
开源免费，可自由修改二次开发

官方直达链接

NPM包直达：https://www.npmjs.com/package/eventbusx-js

文末总结

eventbusx-js 区别于传统订阅发布式事件总线，主打状态监听+消息分发核心能力，没有冗余繁杂功能，专注解决条件判断与状态触发需求，日常中小型项目快速开发使用十分合适，有需要的开发者可以直接安装体验。