DIV CSS 佈局教程網

downloadUrl():三十行搞定 Ajax 請求的輕量函式
編輯:AJAX基礎知識     

用 Google Map API 的時候,注意到它內建的 downloadUrl 函式相當順手,於是照著精神自己寫了一版。用膩了各種框架與物件池之後才發現,對很多場景來說,越簡單的東西反而越合用。

介面

downloadUrl(url, callback, data);
  • url:請求的網址,不另行說明。
  • callback:回調函式,被呼叫時會收到兩個參數——data 即 responseText,responseCode 即 status。
  • data:要 POST 的資料;使用 GET 時可省略。

兩種呼叫寫法

直接把回調函式寫在參數中:

downloadUrl('https://www.ugia.cn/wp-data/test.htm', function (data, responseCode) {
    alert(data);   // 在這裡處理返回的數據
});

先定義好再傳入:

function test(data, responseCode) {
    alert(data);   // 在這裡處理返回的數據
}

downloadUrl('https://www.ugia.cn/wp-data/test.htm', test);

原始碼

/**
 * download url lite
 *
 * @author: legend (legendsky@hotmail.com)
 * @version: 1.0
 *
 * @param string url
 * @param string callback  回調函數
 * @param string data      post數據
 *
 * @return void
 */
function downloadUrl(url, callback, data) {
    // init:附加隨機參數避免讀到快取
    url += url.indexOf("?") > 0 ? "&" : "?";
    url += "random_download_url=" + Math.random();

    if (typeof data == 'undefined') {
        var data = null;
    }

    method = data ? 'POST' : 'GET';

    // create XMLHttpRequest object
    if (window.XMLHttpRequest) {
        var objXMLHttpRequest = new XMLHttpRequest();
    } else {
        var MSXML = ['MSXML2.XMLHTTP.5.0', 'MSXML2.XMLHTTP.4.0', 'MSXML2.XMLHTTP.3.0',
                     'MSXML2.XMLHTTP', 'Microsoft.XMLHTTP'];
        for (var n = 0; n < MSXML.length; n++) {
            try {
                var objXMLHttpRequest = new ActiveXObject(MSXML[n]);
                break;
            } catch (e) {
            }
        }
    }

    // send request
    with (objXMLHttpRequest) {
        try {
            open(method, url, true);

            if (method == 'POST') {
                setRequestHeader('Content-Type', 'application/x-www-form-urlencoded; charset=UTF-8');
            }

            send(data);
        } catch (e) {
            alert(e);
        }

        // on ready
        onreadystatechange = function () {
            if (objXMLHttpRequest.readyState == 4) {
                callback(objXMLHttpRequest.responseText, objXMLHttpRequest.status);
                delete (objXMLHttpRequest);
            }
        }
    }
}

設計上的幾個取捨

  • 方法自動判定:有 data 就走 POST、沒有就走 GET,呼叫端不必多傳一個參數。
  • 回調只收兩個純值:不同於把整個 xhr 物件交出去,這裡只給 responseText 與 status,呼叫端的程式碼更乾淨,也不必自己去挖 readyState。
  • 用後即丟:回調結束後 delete 掉物件,讓瀏覽器盡早回收資源。
  • 不判 status 是否 200:這是刻意的——把狀態碼交給呼叫端自行決定如何處理,函式本身保持中立。

整體不到四十行,卻把跨瀏覽器建構、GET/POST 切換、防快取、狀態通知四件事都做完了。若你的需求只是「抓一段資料回來處理」,這樣的粒度通常已經足夠,不必再引入更重的框架。

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