DIV CSS 佈局教程網

JavaScript 定時輪詢:呼叫成功後自動停止的寫法
編輯:JavaScript綜合知識     

「每隔一秒試一次,成功就停」是很常見的需求,例如等待某個非同步任務完成、輪詢伺服器狀態、重試送出。用 setInterval 搭配 clearInterval 就能做到,但細節比想像中多。

基本實作

// 定時器 handle 必須是全域變數,否則 clearInterval 拿不到它
var refreshid = "";

function felsh() {
    refreshid = setInterval(getResult, 1000);
}

function getResult() {
    try {
        var str = addFunctionName();
        if (str == "1") {
            return str;             // 尚未成功,繼續等下一次
        }
        clearInterval(refreshid);   // 成功後清除定時器
    } catch (e) {
        alert('異常:' + e.description);
    }
    return "";
}

function addFunctionName() {
    return "1";
}

命名衝突的坑

特別提醒:GetResult 在 .NET 裡也是常見名稱,若與 .NET 混用容易發生呼叫不到或歧義的問題。因此範例刻意把方法命名為 getResult 並搭配獨特前綴,實際專案建議加上命名空間或前綴(如 myApp_pollResult)避免全域污染。

幾個必須處理的問題

1. handle 一定要能被 clearInterval 取用。若 refreshid 宣告在函式內部,清除時就找不到它,定時器永遠不會停。

2. 記得在頁面卸載時清理。單頁應用程式中,若離開畫面時沒清掉定時器,背景會持續發請求,不僅浪費資源,回呼裡操作已不存在的 DOM 也會報錯。

3. 加上重試上限。如果目標永遠不會成功,無限輪詢會變成災難。

改良版

var timer = null;
var retry = 0;
var MAX_RETRY = 10;

function startPolling() {
    stopPolling();
    retry = 0;
    timer = setInterval(poll, 1000);
}

function stopPolling() {
    if (timer !== null) {
        clearInterval(timer);
        timer = null;
    }
}

function poll() {
    retry++;
    if (retry > MAX_RETRY) {
        stopPolling();
        console.warn('已達最大重試次數,停止輪詢');
        return;
    }

    try {
        if (checkResult()) {        // 成功
            stopPolling();
            onSuccess();
        }
    } catch (e) {
        stopPolling();
        console.error('輪詢發生錯誤:', e);
    }
}

window.addEventListener('beforeunload', stopPolling);

setInterval 還是 setTimeout?

setInterval 的固定間隔不考慮前一次是否執行完畢。若每次輪詢會發 AJAX 請求,而網路慢於間隔,請求就會堆疊。這種情況更適合用 setTimeout 自我遞迴:

function pollOnce() {
    $.ajax({
        url: 'status.ashx',
        success: function (res) {
            if (res.done) { render(res); return; }   // 結束,不再排下一次
            setTimeout(pollOnce, 1000);              // 排下一次
        },
        error: function () { setTimeout(pollOnce, 2000); }
    });
}
pollOnce();

這個寫法保證「上一次做完才排下一次」,不會堆積,也讓間隔可以依情況動態調整(例如失敗時退避到 2 秒)。若只需要等待單一條件成立,也可以考慮回傳 Promise 的 await 搭配 for 迴圈,可讀性更高。而如果是真正的即時性需求(聊天、股價),用 WebSocket 或伺服器推送會比輪詢有效率得多。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved