Hai kiểu URL
Cả hai đều dùng được trên cùng một host, nên phần lớn link hiện có chỉ cần đổi hostname.
https://cdnjs.vappcdn.com/ajax/libs/<library>/<version>/<file>
https://cdnjs.vappcdn.com/<package>@<version>/<path>Ghi chú
- Phiên bản luôn ghi rõ. Không có “latest” trôi nổi — URL chạy được hôm qua thì hôm nay trả về đúng những byte đó.
- File được lấy từ registry chính thức, nên thư viện nào có publish ở đó là dùng được ở đây, không cần chúng tôi duyệt danh sách.
- Package có scope vẫn chạy:
/@scope/name@1.2.3/dist/index.js. - Danh sách ở trên là bản rút gọn để duyệt cho tiện; mọi package đã publish đều truy cập được dù có nằm trong đó hay không.
Endpoint
| Đường dẫn | Công dụng |
|---|---|
/ajax/libs/… | URL kiểu library. |
/<pkg>@<ver>/… | URL kiểu package. |
/api/libraries.json | Chỉ mục mà trang này tìm kiếm. |
Câu hỏi thường gặp
Làm sao tôi biết các bạn trả đúng byte?
Mỗi package đều kèm thuộc tính integrity. Trình duyệt tự tính lại mã băm và từ chối file nếu lệch một byte, nên bạn không phải tin lời chúng tôi — file bị thay hay bị sửa sẽ hỏng ngay chứ không chạy. Bạn tự kiểm tra được với registry:
curl -s <url> | openssl dgst -sha384 -binary | openssl base64 -AURL có chạy lâu dài không?
Phiên bản ghi rõ và bất biến, nên URL chạy được hôm qua thì hôm nay trả về đúng những byte đó. Không có “latest” trôi nổi để đổi dưới chân bạn. Nếu một phiên bản bị gỡ khỏi registry, chúng tôi vẫn phục vụ bản đã giữ thay vì để trang của bạn hỏng.
Nếu đường truyền quốc tế đứt thì sao?
Tài nguyên đã có ở đây vẫn phục vụ bình thường, và tìm kiếm vẫn chạy, vì cả hai nằm trên máy chủ này chứ không phải lấy về theo yêu cầu. Thứ chưa ai từng gọi thì không thể phục vụ — nói khác đi là chúng tôi nói dối.
Những kiểu URL nào dùng được?
Ba kiểu, nên phần lớn link hiện có chỉ cần đổi hostname:
/ajax/libs/<library>/<version>/<file>
/<package>@<version>/<path>
/npm/<package>@<version>/<path>Package có scope chạy được cả ba — /@scope/name@1.2.3/dist/index.js. URL kiểu repository trỏ thẳng vào mã nguồn tuỳ ý thì không hỗ trợ: không có bước publish và không có phiên bản bất biến, đó là một mô hình tin cậy khác hẳn registry.
Có phải package nào cũng được liệt kê?
Không. Danh sách duyệt được là bản rút gọn, và những package không có bản build dùng thẳng trong trình duyệt thì cố tình để ngoài thay vì liệt kê kèm một link 404. Mọi package đã publish vẫn truy cập được bằng URL dù có nằm trong đó hay không.
Có giới hạn tần suất không?
Hiện chưa có giới hạn theo request. Nếu có thay đổi, nó sẽ được ghi ở đây trước khi được áp dụng.
Bắt đầu
Tạo tài khoản và quản lý zone, tài nguyên từ bảng điều khiển.
Mở bảng điều khiển