隨著 JS 代碼量增長,模組化、自動化啟動成為必要。本文介紹一種「註冊式類別管理模式」:定義基礎類別、靜態註冊表、掃描實例化並自動呼叫初始化方法,實現類似 Java Spring/@PostConstruct 的依賴管理與啟動流程。
// 1. 基礎類別:定義生命週期鉤子
class BaseModule {
constructor() { this.initialized = false; }
init() { throw new Error('必須實作 init()'); }
destroy() {} // 可選清理
}
// 2. 註冊中心:單例管理所有模組
class ModuleRegistry {
static #instance = null;
static get instance() {
if (!ModuleRegistry.#instance) ModuleRegistry.#instance = new ModuleRegistry();
return ModuleRegistry.#instance;
}
#modules = new Map(); // name -> { Class, instance, deps, initialized }
register(name, Class, deps = []) {
if (this.#modules.has(name)) throw new Error(`模組 ${name} 已註冊`);
this.#modules.set(name, { Class, deps, instance: null, initialized: false });
}
// 拓撲排序解析依賴順序
#resolveOrder() {
const visited = new Set(), visiting = new Set(), order = [];
const visit = (name) => {
if (visiting.has(name)) throw new Error(`循環依賴: ${name}`);
if (visited.has(name)) return;
visiting.add(name);
const { deps } = this.#modules.get(name);
deps.forEach(visit);
visiting.delete(name);
visited.add(name);
order.push(name);
};
this.#modules.forEach((_, name) => visit(name));
return order;
}
async initAll() {
const order = this.#resolveOrder();
for (const name of order) {
const mod = this.#modules.get(name);
mod.instance = new mod.Class();
// 注入依賴實例
mod.deps.forEach(dep => mod.instance[dep] = this.#modules.get(dep).instance);
await mod.instance.init(); // 支援 async init
mod.initialized = true;
}
}
get(name) { return this.#modules.get(name)?.instance; }
getAll() { return Array.from(this.#modules.values()).map(m => m.instance); }
async destroyAll() { /* 反序銷毀 */ }
}
// 3. 裝飾器簡化註冊 (需 Babel/TS)
function Module(name, deps = []) {
return (Class) => ModuleRegistry.instance.register(name, Class, deps);
}
@Module('config')
class ConfigModule extends BaseModule {
async init() {
this.settings = await fetch('/api/config').then(r => r.json());
console.log('[Config] 載入完成');
}
get(key) { return this.settings[key]; }
}
@Module('api', ['config'])
class ApiModule extends BaseModule {
async init() {
this.baseUrl = this.config.get('apiBaseUrl');
this.interceptors = [];
}
request(url, options) { /* ... */ }
}
@Module('auth', ['api', 'config'])
class AuthModule extends BaseModule {
async init() {
this.token = localStorage.getItem('token');
if (this.token) this.api.defaults.headers.Authorization = `Bearer ${this.token}`;
}
login(cred) { return this.api.request('/login', { method: 'POST', body: cred }); }
}
@Module('ui', ['auth'])
class UIModule extends BaseModule {
async init() {
this.auth.on('login', () => this.renderUserMenu());
this.renderAppShell();
}
renderUserMenu() { /* ... */ }
}
// main.js
import './modules/ConfigModule.js';
import './modules/ApiModule.js';
import './modules/AuthModule.js';
import './modules/UIModule.js';
// ... 所有模組檔案只要 import 即會自動註冊 (靜態初始化)
async function bootstrap() {
try {
await ModuleRegistry.instance.initAll();
console.log('🚀 所有模組初始化完成');
// 啟動路由、掛載根組件等
} catch (err) {
console.error('初始化失敗:', err);
// 顯示錯誤頁、上報錯誤追蹤
}
}
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', bootstrap);
} else {
bootstrap();
}
| 模式 | 依賴管理 | 啟動控制 | 適用場景 |
|---|---|---|---|
| IIFE 立即執行 | 手動排序 script 標籤 | 載入即執行 | 極小專案、舊環境 |
| CommonJS/ESM import | 靜態依賴圖 | 模組執行即初始化 | 現代打包工具 |
| 本文註冊模式 | **執行時動態聲明依賴 + 拓撲排序** | **統一入口 await initAll()** | **複雜依賴、需延遲/條件初始化、插件系統、微前端** |
| InversifyJS / Angular DI | 裝飾器 + 容器解析 | 容器啟動 | 大型企業級應用 |
@Module('heavyChart', ['config'])
class HeavyChartModule extends BaseModule {
async init() {
// 條件:只有當頁面包含圖表容器才初始化
if (!document.querySelector('#chart-container')) {
this.initialized = true; // 標記完成但不做重事
return;
}
await this.loadChartLib(); // 動態 import
this.chart = new Chart(...);
}
}
「註冊式類別自動啟動」模式將「定義」、「依賴聲明」、「實例化」、「初始化」四階段分離,解決了大型專案中腳本載入順序耦合、循環依賴難察覺、啟動時機不可控等痛點。核心僅 100 行左右,零依賴,可直接整合進任何 ES6+ 專案,或作為理解依賴注入容器原理的教學範例。