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