Website: the docs site's own service worker can't install (navigateFallback "/" isn't precached)
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 2/5
- Thời gian dự kiến
- 1-3 giờ
- Mức phù hợp với người mới
- 70/100
- Loại issue
- Lỗi
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- javascript
- Lĩnh vực
- devops, documentation
Hướng nghiên cứu
Bắt đầu bằng cách kiểm tra .output/public/sw.js đã được build và cấu hình @vite-pwa/nuxt của trang tài liệu. Chọn một trong các cách khắc phục được đề xuất: gỡ tích hợp PWA hoặc đặt registerType thành autoUpdate và workbox.navigateFallback thành null. Xác nhận trong DevTools rằng service worker được cài đặt.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
From the 2026-10-08 front-end review, checked in the built .output/public/sw.js.
sw.js registers NavigationRoute(createHandlerBoundToURL("/")), but / isn't in the precache manifest (only _payload.json files and _nuxt assets are). Workbox throws non-precached-url when the route is registered, so the worker fails to install. Our own PWA page warns readers about this exact navigateFallback trap.
If it did install, registerType defaults to 'prompt' and the site has no prompt UI, so new docs would wait until every tab is closed.
Fix. Either remove @vite-pwa/nuxt from the docs site (a docs site gains little from it), or set registerType: 'autoUpdate' and workbox.navigateFallback: null. Then confirm in DevTools that the worker installs.
- Ngôn ngữ chính
- Vue
- Star
- 0
- Fork
- 0
- Chỉ số merge pull request
- Không có pull request nào được merge trong 30 ngày
Chuẩn bị môi trường
Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của components-web-app/docs
-
Website: the home page code samples use a broken import path and the non-recommended composableĐang mởbug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
components-web-app/docs#169 ·
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
components-web-app/docs#152 ·
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 58/100
components-web-app/docs#180 · 1 bình luận ·
-
enhancement
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 55/100
components-web-app/docs#179 ·
-
enhancement
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 48/100
components-web-app/docs#178 ·
Tất cả issue của components-web-app/docs
Issue tương tự
-
[Bug] create-before-destroy replacements are omitted from driftCó thể đã có người làm @Lostmanu đã nhận hôm nay. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
InditexTech/kumoss#318 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Deploy & Patch-issues opprettes ikke: create-pnd-issues.yml har feilet hver uke siden 2025-09-08Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 62/100
Altinn/altinn-auth#4359 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
WingedGuardian/GENesis-AGI#3126 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
aws-samples/appmod-blueprints#972 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
The CSS is not lintedĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
WordPress/presence-api#807 ·
Maintainer thường phản hồi trong vòng 1 ngày