萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Node.js 依賴注入實戰:解決模組耦合與測試難題

痛點

Node 模組直接 require 依賴,導致:

  • 單元測試難以 Mock 內建模組(fs、http)或第三方庫
  • 模組間強耦合,難以替換實現

方案:vm 模組隔離上下文注入 Mock

// module-loader.js
const vm = require('vm');
const fs = require('fs');
const path = require('path');

exports.loadModule = function(filePath, mocks = {}) {
    const resolve = mod => mod.startsWith('.') ? path.resolve(path.dirname(filePath), mod) : mod;

    const context = {
        require: name => mocks[name] || require(resolve(name)),
        console,
        exports: {},
        module: { exports: {} }
    };

    vm.runInNewContext(fs.readFileSync(filePath, 'utf8'), context);
    return context.module.exports;
};

使用範例

被測模組 web-server.js:

const fs = require('fs');
module.exports = { readConfig: () => fs.readFileSync('config.json', 'utf8') };

測試代碼:

const {loadModule} = require('./module-loader');

describe('web-server', () => {
    let mod, fsMock;
    beforeEach(() => {
        fsMock = {
            readFileSync: jasmine.createSpy().and.returnValue('{"port":3000}')
        };
        mod = loadModule('./web-server.js', {fs: fsMock});
    });

    it('reads config via mocked fs', () => {
        expect(mod.readConfig()).toBe('{"port":3000}');
        expect(fsMock.readFileSync).toHaveBeenCalledWith('config.json', 'utf8');
    });
});

原理解析

  1. vm.runInNewContext 在全新沙箱執行模組代碼
  2. 自定義 require:優先返回 mocks 中的偽對象,否則委託真實 require
  3. 暴露 exports/module.exports 供模組掛載導出
  4. 相對路徑解析基於被測模組位置

生產級替代方案

  • 依賴注入容器:inversifyjs、tsyringe(TypeScript 裝飾器風格)
  • 手動注入:模組導出工廠函數 module.exports = (deps) => ({...}),調用方傳入依賴
  • ES Modules 動態 import:配合 vi.mock() (Vitest) 或 jest.mock() 原生支援

總結

vm 方案零侵入、適合舊代碼庫快速加測試;新專案推薦工廠函數模式或 DI 容器,類型友好、靜態分析支援更好。

copyright © 萬盛學電腦網 all rights reserved