jQuery.post()

jQuery.post()は、HTTPのPOSTメソッドでリクエストを送信するメソッドである。

構文

jQuery関数には3通りの記述方法がある。それぞれ記述方法が異なるだけで、機能はどれも同じである。

window.jQuery.post(url [, data] [, succss] [, dataType])
jQuery.post(url [, data] [, succss] [, dataType])
$.post(url [, data] [, succss] [, dataType])

url以外のパラメータは省略できる。

引数

jQuery.post()には、次の引数を指定できる。

url
リクエストの送信先URLを指定する。必須パラメータであり、省略できない。
jQuery.post("/submit.php")
data
サーバに送信する値をオブジェクトまたは文字列で指定する。
success
リクエストが成功した場合に実行されるコールバック関数を指定する。
function(data, textStatus, jqXHR) {
  // リクエストが成功したときの処理
}
data
dataTypeに応じて評価された応答データ
textStatus
リクエスト結果を表す文字列
jqXHR
XMLHttpRequestオブジェクト
dataType
サーバから返されるデータ形式(xml, json, script. html)を指定する。

使用例

example.phpページをリクエストして、結果は無視する例を示す。

$.post("example.php");

example.phpページをリクエストし、サーバにデータを送する例を示す。

$.post("example.php", {"key1":"value1", "key2":"value2"});

参考文献

OpenJS Foundation (2023) jQuery.post() jQuery API documentation