Jquery ajax參數設定

參數名

類型

描述

url

String

(預設: 目前頁位址) 發送請求的位址。

type

(預設: "GET") 請求方式 ("POST" 或 "GET")， 預設為 "GET"。注意：其它 HTTP 請求方法，如 PUT 和 Delete 也可以使用，但僅部分浏覽器支援。

timeout

Number

設定請求逾時時間（毫秒）。此設定将覆寫全局設定。

async

Boolean

(預設: true) 預設設定下，所有請求均為異步請求。如果需要發送同步請求，請将此選項設定為 false。注意，同步請求将鎖住浏覽器，使用者其它操作必須等待請求完成才可以執行。

beforeSend

Function

發送請求前可修改 XMLHttpRequest 對象的函數，如添加自定義 HTTP 頭。XMLHttpRequest 對象是唯一的參數。

function (XMLHttpRequest) {

  this; // the options for this ajax request

}

cache

(預設: true) jQuery 1.2 新功能，設定為 false 将不會從浏覽器緩存中加載請求資訊。

complete

請求完成後回調函數 (請求成功或失敗時均調用)。參數： XMLHttpRequest 對象，成功資訊字元串。

function (XMLHttpRequest, textStatus) {

contentType

(預設: "application/x-www-form-urlencoded") 發送資訊至伺服器時内容編碼類型。預設值适合大多數應用場合。

data

Object,

發送到伺服器的資料。将自動轉換為請求字元串格式。GET 請求中将附加在 URL 後。檢視 processData 選項說明以禁止此自動轉換。必須為 Key/Value 格式。如果為數組，jQuery 将自動為不同值對應同一個名稱。如 {foo:["bar1", "bar2"]} 轉換為 '&foo=bar1&foo=bar2'。

dataType

預期伺服器傳回的資料類型。如果不指定，jQuery 将自動根據 HTTP 包 MIME 資訊傳回 responseXML 或 responseText，并作為回調函數參數傳遞，可用值:

"xml": 傳回 XML 文檔，可用 jQuery 處理。

"html": 傳回純文字 HTML 資訊；包含 script 元素。

"script": 傳回純文字 JavaScript 代碼。不會自動緩存結果。

"json": 傳回 JSON 資料 。

error

(預設: 自動判斷 (xml 或 html)) 請求失敗時将調用此方法。這個方法有三個參數：XMLHttpRequest 對象，錯誤資訊，（可能）捕獲的錯誤對象。

function (XMLHttpRequest, textStatus, errorThrown) {

  // 通常情況下textStatus和errorThown隻有其中一個有值

global

(預設: true) 是否觸發全局 AJAX 事件。設定為 false 将不會觸發全局 AJAX 事件，如 ajaxStart 或 ajaxStop 。可用于控制不同的Ajax事件

ifModified

(預設: false) 僅在伺服器資料改變時擷取新資料。使用 HTTP 包 Last-Modified 頭資訊判斷。

processData

(預設: true) 預設情況下，發送的資料将被轉換為對象(技術上講并非字元串) 以配合預設内容類型 "application/x-www-form-urlencoded"。如果要發送 DOM 樹資訊或其它不希望轉換的資訊，請設定為 false。

success

請求成功後回調函數。這個方法有兩個參數：伺服器傳回資料，傳回狀态

function (data, textStatus) {

  // data could be xmlDoc, jsonObj, html, text, etc...

部落格園大道至簡

<a href="http://www.cnblogs.com/jams742003/" target="_blank">http://www.cnblogs.com/jams742003/</a>

轉載請注明：部落格園