首頁  >  文章  >  web前端  >  jquery中ajax法的參數屬性及作用是什麼

jquery中ajax法的參數屬性及作用是什麼

WBOY
WBOY原創
2022-06-14 18:50:352732瀏覽

jquery中ajax方法的參數屬性及作用:1、options屬性,用於設定ajax請求;2、async,預設為非同步請求,設定為false時為同步請求;3、cache,用於設定快取介面;4、data,用於設定發送到伺服器的資料;5、global,用於設定是否觸發局部ajax事件;6、password,用於回應HTTP存取認證請求的密碼等等。

jquery中ajax法的參數屬性及作用是什麼

本教學操作環境:windows10系統、jquery3.6.0版本、Dell G3電腦。

jquery中ajax方法的屬性及作用是什麼

ajax() 方法透過 HTTP 請求載入遠端資料。

此方法是 jQuery 底層 AJAX 實作。簡單易用的高層實作請見 $.get, $.post 等。 $.ajax() 傳回其建立的 XMLHttpRequest 物件。大多數情況下你無需直接操作該函數,除非你需要操作不常用的選項,以獲得更多的彈性。

最簡單的情況下,$.ajax() 可以不帶任何參數直接使用。

注意:所有的選項都可以透過 $.ajaxSetup() 函數來全域設定。

語法

jQuery.ajax([settings])

settings

可選。用於配置 Ajax 請求的鍵值對集合。

可以透過$.ajaxSetup() 設定任何選項的預設值

參數

##options

類型:Object

可選。 AJAX 請求設定。所有選項都是可選的。

async

類型:Boolean

預設值: true。預設設定下,所有請求均為非同步請求。如果需要傳送同步請求,請將此選項設為 false。

注意,同步請求將鎖住瀏覽器,使用者其它操作必須等待請求完成才可以執行。

beforeSend(XHR)

類型:Function

傳送請求前可修改 XMLHttpRequest 物件的函數,例如新增自訂 HTTP 頭。

XMLHttpRequest 物件是唯一的參數。

這是一個 Ajax 事件。如果回傳 false 可以取消本次 ajax 請求。

cache

類型:Boolean

預設值: true,dataType 為 script 和 jsonp 時預設為 false。設定為 false 將不快取此頁面。

jQuery 1.2 新功能。

complete(XHR, TS)

類型:Function

請求完成後回呼函數 (請求成功或失敗之後皆呼叫)。

參數: XMLHttpRequest 物件和一個描述請求類型的字串。

這是一個 Ajax 事件。

contentType

類型:String

預設值: "application/x-www-form-urlencoded"。發送訊息至伺服器時內容編碼類型。

預設值適合大多數情況。如果你明確地傳遞了一個 content-type 給 $.ajax() 那麼它必定會傳送給伺服器(即使沒有資料要傳送)。

context

類型:Object

這個物件用來設定 Ajax 相關回呼函數的上下文。也就是說,讓回呼函數內 this 指向這個物件(如果不設定這個參數,那麼 this 就指向呼叫本次 AJAX 請求時傳遞的 options 參數)。例如指定一個 DOM 元素作為 context 參數,這樣就設定了 success 回呼函數的上下文為這個 DOM 元素。

就像這樣:

$.ajax({ url: "test.html", context: document.body, success: function(){
        $(this).addClass("done");
      }});

data

#類型:String

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

dataFilter

類型:Function

#給 Ajax 傳回的原始資料的進行預處理的函數。提供 data 和 type 兩個參數:data 是 Ajax 傳回的原始數據,type 是呼叫 jQuery.ajax 時提供的 dataType 參數。函數傳回的值將由 jQuery 進一步處理。

dataType

類型:String

預期伺服器傳回的資料類型。如果不指定,jQuery 會自動根據 HTTP 套件 MIME 資訊來智慧判斷,例如 XML MIME 類型就被辨識為 XML。在 1.4 中,JSON 就會產生一個 JavaScript 對象,而 script 則會執行這個腳本。隨後伺服器端傳回的資料會根據這個值解析後,傳遞給回呼函數。可用值:

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

"html": 傳回純文字 HTML 資訊;包含的 script 標籤會在插入 dom 時執行。

"script": 傳回純文字 JavaScript 程式碼。不會自動快取結果。除非設定了 "cache" 參數。注意:在遠端請求時(不在同一個網域下),所有 POST 請求都會轉為 GET 請求。 (因為將使用 DOM 的 script標籤來載入)

"json": 傳回 JSON 資料 。

"jsonp": JSONP 格式。使用 JSONP 形式呼叫函數時,如 "myurl?callback=?" jQuery 會自動取代 ? 為正確的函式名,以執行回呼函數。

"text": 傳回純文字字串

error

#類型:Function

預設值: 自動判斷(xml或html)。請求失敗時呼叫此函數。

有以下三個參數:XMLHttpRequest 物件、錯誤訊息、(可選)擷取的例外物件。

如果發生了錯誤,錯誤訊息(第二個參數)除了得到 null 之外,還可能是 "timeout", "error", "notmodified" 和 "parsererror"。

這是一個 Ajax 事件。

global

類型:Boolean

#是否觸發全域 AJAX 事件。預設值: true。設定為 false 將不會觸發全域 AJAX 事件,如 ajaxStart 或 ajaxStop 可用於控制不同的 Ajax 事件。

ifModified

類型:Boolean

僅在伺服器資料改變時取得新資料。預設值: false。使用 HTTP 套件 Last-Modified 頭資訊判斷。在 jQuery 1.4 中,它也會檢查伺服器指定的 'etag' 來確定資料沒有被修改過。

jsonp

類型:String

在一個 jsonp 請求中重寫回呼函數的名字。這個值用來取代在 "callback=?" 這種 GET 或 POST 請求中 URL 參數裡的 "callback" 部分,例如 {jsonp:'onJsonPLoad'} 會導致將 "onJsonPLoad=?" 傳給伺服器。

jsonpCallback

類型:String

#為 jsonp 請求指定一個回呼函數名稱。這個值將會用來取代 jQuery 自動產生的隨機函數名稱。這主要用來讓 jQuery 產生度獨特的函數名,這樣管理請求更容易,也能方便地提供回呼函數和錯誤處理。你也可以在想讓瀏覽器快取 GET 請求的時候,指定這個回呼函數名稱。

password

類型:String

用於回應HTTP 存取認證請求的密碼

##processData

類型:Boolean

預設值: true。預設情況下,透過data選項傳遞進來的數據,如果是一個物件(技術上講只要不是字串),都會處理轉換成一個查詢字串,以配合預設內容類型"application/x-www-form-urlencoded "。如果要傳送 DOM 樹資訊或其它不希望轉換的訊息,請設定為 false。

scriptCharset

類型:String

只有當請求時dataType 為"jsonp" 或"script",且type 是"GET" 才會用於強制修改charset。通常只在本地和遠端的內容編碼不同時使用。

success

類型:Function

#請求成後的回呼函數。

參數由伺服器傳回,並根據 dataType 參數進行處理後的資料;描述狀態的字串。

這是一個 Ajax 事件。

traditional

類型:Boolean

#如果你想要用傳統的方式來序列化數據,那麼就設定為 true。請參考工具分類下面的 jQuery.param 方法。

timeout

類型:Number

設定請求逾時時間(毫秒)。此設定將覆蓋全域設定。

type

類型:String

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

url

類型:String

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

username

類型:String

用於回應 HTTP 存取認證請求的使用者名稱。

xhr

類型:Function

#需要傳回一個 XMLHttpRequest 物件。預設在 IE 下是 ActiveXObject 而其他情況是 XMLHttpRequest 。用於重寫或提供一個增強的 XMLHttpRequest 物件。這個參數在 jQuery 1.3 以前不可用。

影片教學推薦:

jQuery影片教學
#

以上是jquery中ajax法的參數屬性及作用是什麼的詳細內容。更多資訊請關注PHP中文網其他相關文章!

陳述:
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn