jQuery.getScript(url, [handler])

解説

HTTPリクエスト(GETメソッド)を使用してJavaScriptファイルを取得し、実行します。

jQuery.get(url, [data], [handler], [dataType]) のラッパメソッドです。 以下の呼び出しと等価です。

jQuery.get(url, null, callback, "script");

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

引数

• url ： リクエスト先のURL。
• [callback] ： 通信が成功した場合に実行されるコールバック関数。（オプション）
  jQuery.ajax(settings) のsuccessオプションに指定するコールバック関数と同等です。このコールバック関数には 2つの引数が渡されます。
  

  引数	説明
  data	JavaScriptファイルデータ
  status	リクエスト結果を表す文字列。 参照：jQuery.ajax(settings)#status

戻り値

• XMLHttpRequestオブジェクト

例

例1:test_script.js を取得し実行します。
取得したスクリプトの内容を表示します。

test_script.js

alert("Hello Script!");

$.getScript(
    "/js/test_script.js",       // リクエストURL
    function(data, status) {    // 通信成功時にスクリプトの内容を表示
        $("#test_result")
            .append($("<p/>")
                .append("----- 取得したファイル -----").append("<br/>")
                .append(data)
            );
    }
);

ページトップヘ

ページトップヘ