Share via

使用腳本擷取資料

  • 發行項

本主題包含如何撰寫腳本，透過 Microsoft Windows HTTP 服務 (WinHTTP) 同步或非同步取得資料的腳本。 此範例中示範的概念提供撰寫需要使用 HTTP 通訊協定存取資料的用戶端或仲介層伺服器應用程式的基礎。

必要條件和需求

除了 Microsoft JScript 的工作知識之外，此範例還需要下列各項：

  • Microsoft Windows 軟體發展工具組的目前版本 (SDK) 。
  • 如果您的網際網路連線是透過 Proxy 伺服器，Proxy 組態工具可建立 Microsoft Windows HTTP Services (WinHTTP) 的 Proxy 設定。 如需詳細資訊，請參閱 Proxy 組態工具ProxyCfg.exe。
  • 熟悉 網路術語 和概念。

同步擷取資料

若要建立以同步方式從網頁取得文字的腳本，請執行下列動作：

  1. 開啟文字編輯器。

  2. 將下列程式碼複製到文字編輯器中。

    function getText(strURL)
{
    var strResult;

    try
    {
        // Create the WinHTTPRequest ActiveX Object.
        var WinHttpReq = new ActiveXObject(
                                  "WinHttp.WinHttpRequest.5.1");

        //  Create an HTTP request.
        var temp = WinHttpReq.Open("GET", strURL, false);

        //  Send the HTTP request.
        WinHttpReq.Send();

        //  Retrieve the response text.
        strResult = WinHttpReq.ResponseText;
    }
    catch (objError)
    {
        strResult = objError + "\n"
        strResult += "WinHTTP returned error: " + 
            (objError.number & 0xFFFF).toString() + "\n\n";
        strResult += objError.description;
    }

    //  Return the response text.
    return strResult;
}

WScript.Echo(getText("https://www.microsoft.com/default.htm"));

  3. 將檔案儲存為 「Retrieve.js」。

  4. 在命令提示字元中，輸入 「cscript Retrieve.js」，然後按 ENTER 鍵。

您現在有使用 WinHttpRequest 物件的腳本，以取得網頁 https://www.microsoft.com 的 HTML 原始程式碼。 您可能必須等候數秒，程式碼才會出現。

應用程式只包含一個函式 「getText」。 腳本的第一行會建立 WinHttpRequest 物件。

    // Create the WinHTTPRequest ActiveX Object.
    var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");

當 JScript 引擎遇到這一行時，它會建立這個物件的實例。 如果您收到錯誤訊息：「ActiveX 元件無法建立物件」，則在此行上，最有可能是WinHttp.dll未正確註冊或不存在於系統上。

腳本的下一行會呼叫 Open 方法。

    //  Create an HTTP request.
    WinHttpReq.Open("GET", "https://www.microsoft.com", false);

三個參數會指定要使用的 HTTP 動詞動詞 、資源的名稱，以及是否以同步或非同步方式使用 WinHTTP。 在此範例中，方法使用 HTTP 動詞「GET」 從 https://www.microsoft.com 取得資料。 為最後一個參數指定 FALSE 會決定交易會同步發生。 Open方法不會建立與資源的連線，因為名稱可能表示。 相反地，它會初始化內部資料結構，以維護會話、連線和要求的相關資訊。

Send方法會組合要求標頭，並傳送要求。 在同步模式中呼叫時， Send 方法也會等候回應，再允許應用程式繼續。

    // Send the HTTP request.
    WinHttpReq.Send();

傳送要求之後，腳本會傳回WinHttpRequest物件的ResponseText屬性值。 此屬性包含回應的實體本文，在此案例中為檔的來源。

    // Get the response text.
    return WinHttpReq.ResponseText;

擷取資源的整個文字時，腳本的執行會暫停。 資源文字會從 函式傳回並顯示。

WinHttpRequest物件可確保已配置給 HTTP 交易的任何內部資源都已釋放。

以非同步方式擷取資料

使用 WinHTTP 以非同步方式擷取資料與同步擷取資料非常類似。 藉由進行兩個小型變更，修改上一節中的腳本。

  1. 將 Open 方法的第三個參數設定為 「true」，而不是 「false」，以指定應該以非同步方式執行 WinHTTP 方法。

       //  Create a HTTP request.
    var temp = WinHttpReq.Open("GET", strURL, true);

  2. 先叫用 WaitForResponse 方法，再存取 ResponseText 屬性，以確保已收到整個回應。

        //  Send the HTTP request.
    WinHttpReq.Send();

    // Wait for the entire response.
    WinHttpReq.WaitForResponse();

    //  Retrieve the response text.
    strResult = WinHttpReq.ResponseText;

在腳本中以非同步方式使用 WinHTTP 的主要優點是 Send 方法會立即傳回。 要求是由背景工作執行緒準備並傳送。 這可讓您的應用程式在等候回應時執行其他動作。 嘗試存取回應之前，請先呼叫 WaitForResponse 方法，確定已收到整個回應。 否則會發生錯誤。

WaitForResponse方法也可用來指定交易的逾時值。 選擇性參數可讓您以秒為單位指定逾時值。

WinHttpRequest

HTTP/1.1 批註要求 (RFC 2616)