jQuery.get(url, [data], [handler], [dataType])


version 1.0 以降

解説

HTTPリクエスト(GETメソッド)を使用してデータを取得します。

jQuery.ajax(settings) のラッパメソッドです。

指定したコールバック関数は、通信が成功した場合に実行されます。 通信エラー時、通信完了時のハンドリングを行うには、jQuery.ajax(settings) を使用してください。

引数

  • url : リクエスト先のURL。
  • [data] : サーバに送信するパラメータ。キーと値のペア(ハッシュ)。(オプション)
  • [callback] : 通信が成功した場合に実行されるコールバック関数。(オプション)
    jQuery.ajax(settings)successオプションに指定するコールバック関数と同等です。このコールバック関数には 2つの引数が渡されます。
    引数 説明
    data dataTypeに応じて評価された応答データ
    status リクエスト結果を表す文字列。
    参照:jQuery.ajax(settings)#status
  • [dataType] : 期待するサーバの応答データの形式を指定します。
    参照:jQuery.ajax(settings)#dataType

戻り値

  • XMLHttpRequestオブジェクト

例1:サーバ上にある test_get.php を取得し、ステータスおよび内容を表示します。

test_get.php
<p>このデータは、サーバ上にあります。</p>

$.get(
    "test_get.php",                 // 送信先
    null,
    function(data, status) {        // 通信成功時にデータを表示
        $("#test_result")
            .append($("<p/>")
                .append("----- 通信成功 -----").append("<br/>")
                .append("status: ").append(status).append("<br/>")
                .append("data: ").append(data)
            );
    },
    "html"                          // 応答データ形式
);