前端项目开发/维护中降低成本的方式之一:降低耦合度

问题背景:

复制代码
随着项目功能不断迭代,公共方法或通用组件内部的判断逻辑会越来越多,导致代码臃肿、后期维护成本急剧上升。
典型场景:网络请求返回统一结果(如登录失效、参数错误),但不同页面需要执行不同的业务逻辑。如果将所有页面逻辑都耦合在公共方法中,会让公共模块变得庞大且难以维护。

传统方式:

网络请求:

javascript 复制代码
service.interceptors.response.use(
    async (res) => {
        if(res.headers['set-cookie']){
            cookieHeader = res.headers['set-cookie']
        }
        return res.data;
    },
    (err) => {
        return Promise.reject(err);
    }
);

业务功能:

markdown 复制代码
-   A 页面调用接口,把结果存到 **Pinia/Vuex** 或 **本地存储**
-   B 页面 **监听状态变化**,才能做处理

现在的解决方法:

复制代码
采用【事件总线作为中间件】的设计方案,通过发布订阅模式解耦模块。让各业务页面在自身模块内独立监听、处理事件,既不侵入公共逻辑,也不互相影响,从而显著降低系统耦合度,提升代码可维护性。

代码实现:

定义中间件:

typescript 复制代码
/**
 * 事件总线
 *  作用:
 *      1、监听多个事件,并执行相应的操作
 *      2、降低组件之间的依赖关系,避免后续模块的修改导致其他模块的修改
 */

// 定义事件名称,可以添加多个
const eventNames = ["API:UN_AUTH", "API:VALIDATE_ERROR"] as const

type EventName = (typeof eventNames[number])
class EventEmitter {
    private listeners: Record<EventName, Set<Function>> = {
        "API:UN_AUTH": new Set(),
        "API:VALIDATE_ERROR": new Set(),
    };

    /**
     * 监听事件
     * @param eventName 固定事件名
     * @param listener 监听器函数
     */
    on(eventName: EventName, listener: Function) {
        this.listeners[eventName].add(listener);
    }

    /**
     * 触发事件
     * @param eventName 固定事件名
     * @param args 传递的参数
     */
    emit(eventName: EventName, ...args: any[]) {
        this.listeners[eventName].forEach((listener) => listener(...args));
    }

    /**
     * 移除单个监听器,在页面销毁时执行,避免内存泄露
     * @param eventName 事件名
     * @param listener 待移除的监听器
     */
    off(eventName: EventName, listener: Function) {
        this.listeners[eventName].delete(listener);
    }

    /**
     * 清空某事件的所有监听器可在退出项目时执行
     * @param eventName 事件名
     */
    clear(eventName: EventName) {
        this.listeners[eventName].clear();
    }
}

export default new EventEmitter()
```

网络请求返回结果处:【以下代码只是模拟使用】

php 复制代码
```
if(response.code === 401){
  eventEmitter.emit('API:UN_AUTH', { message: '未授权'})
}
else if(response.code === 404){ 
  eventEmitter.emit('API:VALIDATE_ERROR', { message: '校验失败'})
}
```

页面/组件逻辑处理:

javascript 复制代码
eventEmitter.on("API:UN_AUTH", (res) => {
  console.log("页面的总线",  res)
})

传统方案和事件总线方案的区别:

1、传统方案

markdown 复制代码
-   耦合度较高,一处修改可能牵连其他模块;
-   网络请求返回的数据,必须在**调用处处理**,如需在其他位置使用,必须先存入状态管理或本地存储;
-   遵循 "谁调用接口,谁处理错误" 的模式,错误只回传到调用方。

2、事件总线方案

diff 复制代码
-   耦合度更低,修改 A 模块逻辑不会影响其他模块;
-   不需要中转存储,一处触发事件,所有关心该事件的地方都能直接接收数据;
-   遵循 "谁关心这个事件 / 错误,谁就监听处理",实现真正的解耦与分布式处理。
相关推荐
Front思5 分钟前
前端的.hbs
前端
_.Switch18 分钟前
东方财富股票数据JS逆向:secids字段和AES加密实战
开发语言·前端·javascript·网络·爬虫·python·ecmascript
软件技术NINI18 分钟前
webkit简介及工作流程
开发语言·前端·javascript·udp·ecmascript·webkit·yarn
普通网友19 分钟前
ES6模块化、Promise、async、await、EventLoop、API接口案例_export function 与 await
前端·ecmascript·es6
難釋懷20 分钟前
Vue混入
前端·javascript·vue.js
若梦plus24 分钟前
TypeScript进阶
前端·javascript·typescript·ecmascript
直奔標竿25 分钟前
Java开发者AI转型第二十七课!Spring AI 个人知识库实战(六)——全栈闭环收官,解锁前端流式渲染终极技巧
java·开发语言·前端·人工智能·后端·spring
@PHARAOH1 小时前
WHAT - cursor cli 开发范式
前端·ai·ai编程
子兮曰2 小时前
深入 HTML-in-Canvas:当 Canvas 学会了渲染 DOM,前端图形生态要变天了
前端·javascript·canvas
ws_qy2 小时前
从大模型原理到前端 AI Coding 工程化实践
前端·ai编程