電商類型的秒殺、團購活動,頁面上一定有一個倒數計時器。這個功能看起來簡單,但有一個關鍵設計決策會決定它是「大致能用」還是「真的準確」。
最直覺的寫法是 new Date() 拿瀏覽器時間去減活動開始時間。但這有個致命問題:使用者可以任意修改自己電腦的時鐘。把時間調快就能讓倒數歸零、提早看到秒殺按鈕;調慢則倒數永遠走不完。對分秒必爭的秒殺活動來說,這等於門戶大开。
所以「當前時間」必須以伺服器時間為準。做法是頁面載入時用 Ajax 向伺服器要一次時間戳,之後以這個時間為基準在本地累加。由於頁面是靜態快取,不能每次都讓後端動態輸出時間,因此必須走 Ajax。
var msbegintime = "1323446400000"; // 活動開始時間戳(毫秒)
var msendtime = "1325174400000"; // 活動結束時間戳(毫秒)
// 頁面載入時啟動
<body onload='start()'>
<span id="sk_time"></span> <!-- 倒計時顯示區 -->
<span id="wyz">
<span class="btn_02"> 參加秒殺!!! </span>
</span> <!-- 秒殺按鈕,倒數歸零後會換成可點擊的樣式 -->
<script type="text/javascript">
function start(){
callBackServerTime("sk_time", "wyz", msbegintime, msendtime);
}
</script>
// _showtimediv: 時間顯示區 id
// _showqdiv: 狀態顯示區 id
// 向伺服器發請求,responseText 即為伺服器目前的時間戳
function callBackServerTime(_showtimediv, _showqdiv, _ms_begintime, _ms_endtime) {
var urlstr = "random=" + Math.round(Math.random() * 10000000); // 避免快取
var ajaxobj = new AJAXRequest();
ajaxobj.method = "GET";
ajaxobj.url = "/gz/source/getServerTime.do?" + urlstr;
ajaxobj.callback = function(xmlobj) {
ShowQTime(_showtimediv, _showqdiv, xmlobj.responseText,
_ms_begintime, _ms_endtime);
};
ajaxobj.send();
}
網址上那串 random 參數是為了防止瀏覽器快取回應——否則第二次進入頁面可能拿到幾分鐘前的時間戳。
function ShowQTime(_showtimediv, _showqdiv, _nowtime, _ms_begintime, _ms_endtime) {
_nowtime = Number(_nowtime);
var timmer = Math.floor((_ms_endtime - _nowtime) / 1000);
if (_nowtime >= _ms_begintime && timmer > 0) {
// 活動進行中
document.getElementById(_showtimediv).innerHTML =
"<span class='pim_time'>0</span>天<span class='pim_time'>0</span>小時" +
"<span class='pim_time'>0</span>分鐘<span class='pim_time'>0</span>秒";
document.getElementById(_showqdiv).innerHTML =
"<span class='btn_01'><a href='/gz/sk/v/'> 秒殺開始了!!! </a></span>";
} else {
// 活動尚未開始:計算剩餘時間
var nMS = _ms_begintime - _nowtime; // 時間差(毫秒)
var nD = Math.floor(nMS / (1000 * 60 * 60 * 24)); // 天
var nH = Math.floor(nMS / (1000 * 60 * 60)) % 24; // 時
var nM = Math.floor(nMS / (1000 * 60)) % 60; // 分
var nS = Math.floor(nMS / 1000) % 60; // 秒
if (nD >= 0) {
var _timestr = "";
var snd = nD.toString();
if (snd.length == 1) snd = "0" + snd;
_timestr += "<span class='pim_time'>" + snd + "</span>天";
var snH = nH.toString();
if (snH.length == 1) snH = "0" + snH;
_timestr += "<span class='pim_time'>" + snH + "</span>小時";
var snM = nM.toString();
if (snM.length == 1) snM = "0" + snM;
_timestr += "<span class='pim_time'>" + snM + "</span>分鐘";
var snS = nS.toString();
if (snS.length == 1) snS = "0" + snS;
_timestr += "<span class='pim_time'>" + snS + "</span>秒";
document.getElementById(_showtimediv).innerHTML = _timestr;
} else {
// 活動已結束
document.getElementById(_showtimediv).innerHTML =
"<span class='pim_time'>0</span>天<span class='pim_time'>0</span>小時" +
"<span class='pim_time'>0</span>分鐘<span class='pim_time'>0</span>秒";
document.getElementById(_showqdiv).innerHTML =
"<span class='btn_01'><a href='/gz/sk/v/'> 秒殺結束了!!! </a></span>";
}
}
// 每秒再執行一次,_nowtime 每次加 1000 而不重新請求伺服器
setTimeout("ShowQTime('" + _showtimediv + "','" + _showqdiv + "','" +
(_nowtime + 1000) + "','" + _ms_begintime + "','" + _ms_endtime + "')", 1000);
}
時間差的換算用標準公式:除以 86400000 取整得天数,除以 3600000 對 24 取模得小時,除以 60000 對 60 取模得分鐘,除以 1000 對 60 取模得秒數。
關鍵細節:遞迴時傳入的是 _nowtime + 1000 而非重新向伺服器要時間。這是效能與準確度的折衷——只在頁面載入時校準一次,之後靠本地累加推進,避免每秒都發請求。缺點是若使用者在頁面上停留很久,累積誤差會越來越大。
function AJAXRequest() {
var xmlObj = false;
var CBfunc, ObjSelf;
ObjSelf = this;
try { xmlObj = new XMLHttpRequest; }
catch(e) {
try { xmlObj = new ActiveXObject("MSXML2.XMLHTTP"); }
catch(e2) {
try { xmlObj = new ActiveXObject("Microsoft.XMLHTTP"); }
catch(e3) { xmlObj = false; }
}
}
if (!xmlObj) return false;
this.method = "POST";
this.url;
this.async = true;
this.content = "";
this.callback = function(cbobj) { return; };
this.send = function() {
if (!this.method || !this.url || !this.async) return false;
xmlObj.open(this.method, this.url, this.async);
if (this.method == "POST")
xmlObj.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
xmlObj.onreadystatechange = function() {
if (xmlObj.readyState == 4) {
if (xmlObj.status == 200) {
ObjSelf.callback(xmlObj);
}
}
};
if (this.method == "POST") xmlObj.send(this.content);
else xmlObj.send(null);
};
}
三層 try/catch 是為了相容 IE6 及更早版本不支援 XMLHttpRequest、只能用 ActiveX 的時代。
用 fetch 與非同步函式重寫,程式碼會短很多也清楚很多:
var serverTimeOffset = 0; // 伺服器時間與本地時間的差值
// 校正:取得伺服器時間並計算偏移量
async function syncServerTime(){
var res = await fetch('/api/serverTime', { cache: 'no-store' });
var serverMs = Number(await res.text());
serverTimeOffset = serverMs - Date.now();
}
function pad(n){ return String(n).padStart(2, '0'); }
function renderCountdown(el, remainMs){
if (remainMs <= 0){
el.textContent = '活動已結束';
return false;
}
var s = Math.floor(remainMs / 1000);
var d = Math.floor(s / 86400);
var h = Math.floor(s % 86400 / 3600);
var m = Math.floor(s % 3600 / 60);
var ss = s % 60;
el.innerHTML =
'<span class="pim_time">' + pad(d) + '</span>天' +
'<span class="pim_time">' + pad(h) + '</span>小時' +
'<span class="pim_time">' + pad(m) + '</span>分鐘' +
'<span class="pim_time">' + pad(ss) + '</span>秒';
return true;
}
async function startCountdown(){
await syncServerTime();
var el = document.getElementById('sk_time');
function tick(){
// 用伺服器時間基準 + 本地流逝的時間
var now = Date.now() + serverTimeOffset;
var remain = Number(msbegintime) - now;
if (!renderCountdown(el, remain)){
document.getElementById('wyz').innerHTML =
'<a class="btn_01" href="/gz/sk/v/">秒殺開始了!!!</a>';
return; // 結束,停止計時
}
setTimeout(tick, 1000);
}
tick();
}
前面提到本地累加會累積誤差。實務上的解法是每隔一段時間(例如每 5 分鐘)重新同步一次伺服器時間:
setInterval(syncServerTime, 5 * 60 * 1000);
或者更精準的做法:記錄同步時的本地時間戳,之後用 performance.now() 的差值推算真實流逝時間,這樣即使系統時鐘被 NTP 校正或使用者手動改動,倒數也不會亂掉。
1323446400000 是 13 位數的毫秒級時間戳,若後端給的是 10 位數的秒級時間戳,前端要記得乘 1000,這是最常見的「倒數變成幾萬天」的原因。innerHTML 整段重寫會造成不必要的重排。可以只更新秒數那個 span 的 textContent。setTimeout("ShowQTime('...')", 1000))等同再走一次 eval,應改成閉包傳函式參照。