Chính sách hỗ trợ
Các dòng phát hành đang hoạt động và LTS, tiêu chí xác định thay đổi phá vỡ tương thích và môi trường chạy được hỗ trợ.
Trang này trình bày thời gian mỗi dòng phát hành Text.js nhận bản sửa lỗi và những thay đổi nào được coi là thay đổi phá vỡ tương thích.
Các dòng phát hành
| Trạng thái | Nội dung cập nhật | Thời hạn |
|---|---|---|
| Đang phát triển | Tính năng, bản sửa lỗi, bản vá bảo mật | Đến phiên bản chính tiếp theo |
| LTS bảo trì | Bản sửa lỗi nghiêm trọng và bản vá bảo mật | 12 tháng sau khi phiên bản chính tiếp theo phát hành |
| Hết vòng đời | Không có | — |
Chỉ phiên bản phụ mới nhất của một phiên bản chính nhận bản vá: khi 1.5.0 phát hành, bản sửa lỗi sẽ vào 1.5.x, không phải 1.4.x. Khi 2.0.0 phát hành, phiên bản phụ cuối cùng của 1.x trở thành dòng LTS bảo trì và được phát hành dưới các dist-tag lts và v1-lts.
| Phiên bản | Trạng thái | Hỗ trợ đến |
|---|---|---|
| 1.x | Đang phát triển | 12 tháng sau 2.0.0 |
Những lỗi chúng tôi sửa trên LTS
- Lỗ hổng bảo mật trong các gói Text.js
- Sự cố ứng dụng, mất dữ liệu và lỗi build không có giải pháp khắc phục tạm thời
- Khả năng tương thích với các bản phát hành Chrome, Edge, Firefox và Safari mới làm hỏng quá trình render trong console
- Khả năng tương thích với môi trường chạy và đích triển khai được hỗ trợ
Tính năng mới, cải tiến hiệu năng và tái cấu trúc mã chỉ có trên dòng đang phát triển.
Thay đổi phá vỡ tương thích
Những mục sau chỉ thay đổi trong phiên bản chính, sau khi có cảnh báo ngừng sử dụng trong ít nhất một phiên bản phụ:
- Các export công khai của
@textjs/app,@textjs/reactvà@textjs/core, bao gồm@textjs/app/servervà@textjs/app/cache - Tùy chọn trong
text.config.ts, lệnh và cờ CLItext - Quy ước tệp trong
app/,middleware.tsvà cấu hình phân đoạn route - Cấu trúc đầu ra của adapter (
.vercel/output,_worker.js,dist/server.js)
Không áp dụng cho: API có đánh dấu thử nghiệm hoặc unstable_, bao gồm mọi thứ trong @textjs/core/experimental và @textjs/react/experimental (chúng có thể thay đổi trong phiên bản phụ, kèm ghi chú trong nhật ký thay đổi), thành phần nội bộ như @textjs/core/internal, header x-middleware-* và siêu dữ liệu build .text/, bản phát hành canary, cùng chuỗi định dạng và CSS cụ thể của console.log (frame vẫn có hình thức giống hệt; quá trình mã hóa chúng có thể nhanh hơn).
Hỗ trợ môi trường chạy
| Môi trường chạy | Phạm vi hỗ trợ |
|---|---|
| Chrome / Edge DevTools | Bản ổn định hiện tại và hai bản ổn định trước đó |
| Console của Firefox và Safari | Bản ổn định hiện tại |
| Node.js | Các bản LTS đang phát triển và bảo trì (text start, hàm Vercel) |
| Bun | 1.x mới nhất |
| Cloudflare Workers | compatibility_date từ 2025-01-01 trở đi, nodejs_compat |
Ngừng hỗ trợ phiên bản môi trường chạy đã hết vòng đời không phải là thay đổi phá vỡ tương thích.
Bảo mật
Báo cáo riêng về lỗ hổng qua [email protected] hoặc qua thông báo bảo mật GitHub. Các bản sửa lỗi phát hành đồng thời cho mọi dòng còn được hỗ trợ, và thông báo bảo mật được công bố khi các phiên bản đã vá có trên npm.
Xem Kênh phát hành để biết cách tạo phiên bản và dist-tag.