萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery + Cookie 實現防刷新的在線考試倒計時系統

業務場景與核心難點

在線考試系統要求:

  1. 倒計時不可被頁面刷新重置(防作弊)
  2. 倒計時不可被篡改本地時間繞過
  3. 考試結束自動交卷

解決方案:服務器下發截止時間戳 + 本地 Cookie 持久化剩餘毫秒數 + 定時器輪詢。即使用戶刷新頁面、修改系統時間,Cookie 中記錄的剩餘時間仍單調遞減。

核心代碼實現

1. 初始化邏輯(頁面加載時)

$(function() {
  // 服務端渲染的考試總時長(分鐘),實際應從後端模板變量獲取
  var examMinutes = parseInt('${exampaper.paperTime}'); // 如 120
  var totalMs = examMinutes * 60 * 1000;
  var examineeId = '${examinee.examineeId}'; // 唯一標識
  
  // Cookie 鍵名:exam_剩餘時間_考生ID
  var cookieKey = 'exam_remain_' + examineeId;
  
  // 首次進入:寫入 Cookie(過期時間 = 考試結束時間)
  if (!hasCookie(cookieKey)) {
    var expireDate = new Date(Date.now() + totalMs);
    setCookie(cookieKey, totalMs, expireDate);
  }
  
  // 啟動倒計時
  startCountdown($('#remainTime'), cookieKey);
});

2. Cookie 操作工具函數

// 設置 Cookie(支持 Date 對象或毫秒數)
function setCookie(name, value, expires) {
  var str = name + '=' + encodeURIComponent(value);
  if (expires) {
    if (expires instanceof Date) {
      str += ';expires=' + expires.toUTCString();
    } else if (typeof expires === 'number') {
      var d = new Date();
      d.setTime(d.getTime() + expires);
      str += ';expires=' + d.toUTCString();
    }
  }
  str += ';path=/'; // 全站可訪問
  document.cookie = str;
}

// 讀取 Cookie
function getCookie(name) {
  var arr = document.cookie.split('; ');
  for (var i = 0; i < arr.length; i++) {
    var kv = arr[i].split('=');
    if (kv[0] === name) return decodeURIComponent(kv[1]);
  }
  return null;
}

// 檢查 Cookie 是否存在
function hasCookie(name) {
  return getCookie(name) !== null;
}

// 更新 Cookie 值(保持原過期時間)
function updateCookieValue(name, newValue) {
  var old = getCookie(name);
  if (old === null) return false;
  // 解析原過期時間(簡化:實際應解析 expires 字段)
  // 此處演示:重新設置相同過期時長
  var expireMs = parseInt(old) - (Date.now() - (Date.now() - parseInt(old))); // 邏輯需根據實際存儲調整
  // 更簡單:存儲「截止時間戳」而非剩餘毫秒,則無需更新過期時間
  setCookie(name, newValue); 
  return true;
}

3. 倒計時核心邏輯

function startCountdown($displayElem, cookieKey) {
  function tick() {
    var remainMs = parseInt(getCookie(cookieKey));
    
    // 異常保護
    if (isNaN(remainMs)) {
      alert('數據異常,請聯繫管理員');
      return;
    }
    
    if (remainMs <= 0) {
      // 時間到:自動交卷
      $displayElem.text('00:00:00');
      alert('考試時間到!系統將自動交卷。');
      submitExam(); // 業務提交函數
      return;
    }
    
    // 格式化顯示 HH:MM:SS
    var seconds = Math.floor(remainMs / 1000);
    var h = String(Math.floor(seconds / 3600)).padStart(2, '0');
    var m = String(Math.floor((seconds % 3600) / 60)).padStart(2, '0');
    var s = String(seconds % 60).padStart(2, '0');
    $displayElem.text(h + ':' + m + ':' + s);
    
    // 更新 Cookie:剩餘毫秒數 - 1000
    var newRemain = remainMs - 1000;
    updateCookieValue(cookieKey, newRemain);
    
    // 下一秒
    setTimeout(tick, 1000);
  }
  
  tick(); // 立即執行首次
}

關鍵安全增強(生產環境必備)

1. 服務端時間同步

頁面加載時請求 /api/server-time 獲取服務器時間戳,計算 本地時間偏移量 = 本地時間 - 服務器時間,所有倒計時基於 Date.now() - offset 計算,防止用戶修改本地系統時間。

2. 存儲「截止時間戳」而非「剩餘毫秒」

// 寫入 Cookie 時存儲絕對截止時間
var deadline = Date.now() + totalMs;
setCookie(cookieKey, deadline, new Date(deadline));

// tick 時計算剩餘
var deadline = parseInt(getCookie(cookieKey));
var remainMs = deadline - (Date.now() - timeOffset);

優勢:無需每秒更新 Cookie,減少 I/O;過期時間與截止時間一致,瀏覽器自動清理。

3. 防篡改簽名

// 寫入時添加簽名
var payload = deadline + '|' + examineeId;
var signature = hash(payload + SECRET_KEY); // 後端驗證用同一密鑰
setCookie(cookieKey, payload + '|' + signature);

前端驗證簽名一致性,防止用戶手動修改 Cookie 值。

4. 可見性狀態處理

document.addEventListener('visibilitychange', function() {
  if (document.hidden) {
    // 頁面隱藏(切換標籤頁、最小化):暫停 UI 更新,但時間繼續流逝
    // 因為基於 deadline 計算,無需特殊處理
  } else {
    // 頁面顯示:立即刷新顯示
    tick();
  }
});

完整 HTML 頁面模板片段

<div class="exam-header">
  <h2>在線考試系統</h2>
  <div class="timer" id="remainTime">00:00:00</div>
</div>
<form id="examForm">
  <!-- 試題內容 -->
  <button type="button" onclick="submitExam()">提交試卷</button>
</form>

<script src="jquery.min.js"></script>
<script src="exam-timer.js"></script>

總結與擴展建議

  1. 核心原則:時間權威在服務端,前端僅做展示與輔助防刷新
  2. Cookie 替代方案:localStorage(容量大、無過期自動清理,需手動清理)、sessionStorage(標籤頁隔離,刷新保留,關閉標籤頁清除)
  3. WebSocket 推送:高並發考試場景,服務端統一廣播剩餘時間,客戶端僅渲染,徹底杜絕客戶端計算誤差
  4. 異常恢復:網絡斷開重連時,重新向服務端請求最新剩餘時間同步

通過「服務端授時 + 客戶端持久化 + 定時同步」三重保障,構建可靠、防作弊的在線考試倒計時系統。

copyright © 萬盛學電腦網 all rights reserved