里程碑達成:TypeORM v1.0 beta 推出
經過 10 多年開發、累計超過 1.9 億次下載和每週 360 萬次安裝量,TypeORM 終於推進到 v1.0 beta 階段。開發團隊已釋出 beta 版本供社群測試(npm install typeorm@beta),並尋求使用者回饋以完成最終發佈。
API 清理與升級路徑
v1.0 的主要變動是移除所有在 v0.3.0(四年前)就標記廢棄的 API。若開發者已持續跟進廢棄警告,升級應該相當順暢。官方提供完整遷移指南協助使用者過渡。
全面的資料庫支援
TypeORM 是目前 JavaScript/TypeScript 生態中支援資料庫種類最多的 ORM,涵蓋:
- Google Spanner、Microsoft SQL Server、MySQL/MariaDB、MongoDB、Oracle、PostgreSQL、SAP HANA 和 SQLite
- 支援衍生資料庫與不同驅動程式
- 涵蓋 NoSQL(MongoDB)與傳統 SQL 資料庫
靈活的架構模式
TypeORM 獨特之處在於同時支援「Data Mapper」與「Active Record」兩種模式,讓開發者可根據需求選擇。Data Mapper 模式提供更高的解耦性和可擴展性;Active Record 模式則更簡潔直觀。這種彈性使開發者能撰寫高品質、可維護的應用,無論規模大小。
核心功能
- 實體與欄位定義、資料庫特定欄位型別
- Entity Manager 與 Repository 模式
- 關聯支援:單向、雙向、自參考關聯,以及預先載入與延遲載入
- 事務、遷移與自動遷移生成
- 連線池、副本與多資料庫實例管理
- 強大的 QueryBuilder,支援 join、分頁、快取與串流
- 事件監聽與 subscribers(hook)
- 跨平台相容:Node.js、瀏覽器、React Native、Ionic、Cordova、Electron 等
完整的生態系統
官方提供多個示例專案展示與各框架的整合方式(Express、Koa、React 等),並有豐富的社群擴充工具:
- 模型生成、ER 圖表生成
- Fixtures 載入器、資料庫建立與種子資料工具
- GraphQL 關聯自動生成、Valibot 架構轉換等
TypeORM 深受 Hibernate、Doctrine 與 Entity Framework 等成熟 ORM 啟發,致力於提供業界最佳實踐,支援 TypeScript 與 JavaScript、ESM 與 CommonJS。
🎉TypeORM v1.0 Beta is here!
— TypeORM (@typeormjs) March 25, 2026
After 10+ years, 190M+ downloads, and 3.6M weekly installs, TypeORM is finally approaching v1.0.
The beta is available now: npm install typeorm@beta
We need your help getting it across the finish line. 🧵
What's changing?
— TypeORM (@typeormjs) March 25, 2026
v1.0 removes all APIs deprecated in v0.3.0 (four years ago). If you've been keeping up with deprecation warnings, the upgrade should be smooth.
Full migration guide: https://t.co/gmt3UCjAqL
