Files
Bkk1234 fcdab3ac80 pwa: automatic update UX - no more hard refresh
- ui/version.json: server-side version marker, polled by pwa.js (load, 5 min,
  tab focus, network online); mismatch -> toast + auto reload once per version
- pwa.js: silent reload when tab hidden, guarded reload (sessionStorage) so a
  partial deploy cannot loop, ATUpdate.check() exposed for testing
- _shared.css: .mu-update-toast pill (bottom center, reduced-motion aware)
- shell js/css get ?v=<version> automatically (bump-version.py) so HTTP cache
  cannot serve stale files before the service worker takes control
- sw: cache fallback now ignores query string (precache still matches ?v= URLs)
- bump-version.py: writes version.json + verifies it in --check
- VERSION 2026.09.27.108
2026-11-03 00:32:41 +07:00

167 lines
7.7 KiB
JavaScript

/* ============================================================
Atroute — PWA registration + auto-update (ผู้ใช้ไม่ต้องกดอะไรเลย)
------------------------------------------------------------
ชั้นกันแคชที่ทำงานร่วมกัน — "ไม่มีใครต้องกด Ctrl+Shift+R"
1. shell assets (js/css) มี ?v=<version> → HTTP cache เห็นเป็นไฟล์ใหม่ทันที
(bump-version.py เติมให้อัตโนมัติ)
2. SW network-first + cache:"no-store" → ออนไลน์ได้ของใหม่เสมอ (ui/sw.js)
3. reg.update() ทุกครั้งที่เปิดหน้า + ทุก 30 นาที
4. version.json ← ตัวชี้ขาด: เวอร์ชันบนเซิร์ฟเวอร์ ≠ meta ในหน้า
→ ขึ้น toast แล้วรีโหลดเอง (รีโหลดครั้งเดียวต่อเวอร์ชัน กันลูป)
ตรวจตอนเปิดหน้า · ทุก 5 นาที · ตอนกลับมาที่แท็บ · ตอนเน็ตกลับมา
หมายเหตุ: ไม่มีปุ่ม "ติดตั้งแอป" ลอยมุมขวาล่าง (เอาออกตามคำขอ)
============================================================ */
(function () {
var CHECK_INTERVAL_MS = 5 * 60 * 1000; // ตรวจ version.json ทุก 5 นาที
var SW_INTERVAL_MS = 30 * 60 * 1000; // ตรวจ sw.js ทุก 30 นาที
var RELOAD_GUARD = 'at_reloaded_for'; // sessionStorage — กันรีโหลดวน
var metaEl = document.querySelector('meta[name="app-version"]');
var currentVersion = metaEl ? metaEl.content : '';
function t(key, fallback) {
var v = (window.I18N && I18N.t) ? I18N.t(key) : key;
return (!v || v === key) ? fallback : v;
}
/* ---------- toast เล็ก ๆ ล่างจอ (ไม่บล็อกการใช้งาน) ---------- */
var toastEl = null, toastTimer = null;
function showToast(msg) {
if (document.querySelector('.mu-update-toast')) return;
toastEl = document.createElement('div');
toastEl.className = 'mu-update-toast';
toastEl.setAttribute('role', 'status');
toastEl.setAttribute('aria-live', 'polite');
var dot = document.createElement('span');
dot.className = 'mu-update-dot';
dot.setAttribute('aria-hidden', 'true');
var text = document.createElement('span');
text.textContent = msg;
toastEl.appendChild(dot);
toastEl.appendChild(text);
document.body.appendChild(toastEl);
toastTimer = setTimeout(function () { if (toastEl) toastEl.classList.add('is-in'); }, 20);
}
function hideToast() {
clearTimeout(toastTimer);
if (!toastEl) return;
toastEl.classList.remove('is-in');
var el = toastEl;
toastEl = null;
setTimeout(function () { if (el) el.remove(); }, 300);
}
/* ---------- รีโหลดครั้งเดียวต่อเวอร์ชัน (กันลูป) ---------- */
function alreadyReloaded(ver) {
try { return sessionStorage.getItem(RELOAD_GUARD) === ver; } catch (e) { return false; }
}
function reloadOnce(ver) {
try {
if (alreadyReloaded(ver)) return;
sessionStorage.setItem(RELOAD_GUARD, ver);
} catch (e) { /* โหมดส่วนตัว: ยอมให้รีโหลดได้ */ }
location.reload();
}
/* ---------- พบเวอร์ชันใหม่ → แจ้ง + อัปเดตเอง ---------- */
var applying = false;
function applyUpdate(nextVersion) {
if (applying) return;
/* รีโหลดเพื่อเวอร์ชันนี้ไปแล้วแต่ยังไม่ตรง (เช่นเซิร์ฟเวอร์ยังไม่ลงไฟล์ครบ)
→ หยุดเงียบ ๆ ไม่เด้ง toast ซ้ำให้รำคาญ */
if (alreadyReloaded(nextVersion)) return;
applying = true;
showToast(t('update.applying', 'มีเวอร์ชันใหม่ — กำลังอัปเดต…'));
/* แท็บถูกซ่อน (ผู้ใช้ไม่ได้ดูอยู่) → รีโหลดเลย ไม่รบกวน */
if (document.hidden) { reloadOnce(nextVersion); return; }
var done = false;
function finish() {
if (done) return;
done = true;
reloadOnce(nextVersion);
}
/* ขอ SW ใหม่ก่อน — ถ้าได้ controllerchange จะรีโหลดจากตรงนั้น */
if (navigator.serviceWorker) {
navigator.serviceWorker.addEventListener('controllerchange', finish, { once: true });
navigator.serviceWorker.getRegistration()
.then(function (reg) { if (reg) return reg.update(); })
.catch(function () {});
}
/* ไม่ว่า SW จะทันหรือไม่ ภายใน 2.5 วิ รีโหลดเพื่อรับ HTML/JS/CSS ใหม่ */
setTimeout(finish, 2500);
}
/* ---------- ตรวจ version.json (ตัวชี้ขาดว่ามีของใหม่ไหม) ---------- */
function checkVersion() {
if (!currentVersion) return Promise.resolve(null);
return fetch('./version.json?t=' + Date.now(), { cache: 'no-store' })
.then(function (r) { return r.ok ? r.json() : null; })
.then(function (d) {
if (!d || !d.version) return null;
if (String(d.version) !== String(currentVersion)) {
applyUpdate(String(d.version));
return d.version;
}
return null;
})
.catch(function () { return null; }); /* ออฟไลน์/ยังไม่มีไฟล์ = ไม่ทำอะไร */
}
if (!('serviceWorker' in navigator)) {
/* ไม่มี SW (เบราว์เซอร์เก่า): ยังตรวจ version.json ได้ */
checkVersion();
setInterval(checkVersion, CHECK_INTERVAL_MS);
return;
}
window.addEventListener('load', function () {
navigator.serviceWorker
.register('./sw.js', { updateViaCache: 'none' })
.then(function (reg) {
reg.update();
setInterval(function () { reg.update(); }, SW_INTERVAL_MS);
/* SW ใหม่接管แล้ว → รับเวอร์ชันใหม่ (รีโหลดครั้งเดียวต่อเวอร์ชัน) */
navigator.serviceWorker.addEventListener('controllerchange', function () {
reloadOnce(currentVersion || 'sw');
});
})
.catch(function () {
/* ไม่มี SW = ไม่มีโหมดออฟไลน์ — เว็บยังใช้งานปกติ */
});
checkVersion();
setInterval(checkVersion, CHECK_INTERVAL_MS);
/* กลับมาที่แท็บ/สลับแอปกลับมา (มือถือ) → ตรวจทันที */
document.addEventListener('visibilitychange', function () {
if (document.visibilityState === 'visible') {
hideToast();
checkVersion();
}
});
/* เน็ตกลับมา → ตรวจอีกรอบ */
window.addEventListener('online', function () { checkVersion(); });
});
/* เปิดให้ทดสอบ/สั่งเองได้ */
window.ATUpdate = {
check: checkVersion,
version: currentVersion,
apply: applyUpdate,
_toast: showToast
};
})();