XMLHttpRequest:open() 方法
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
備註: 此功能可在 Web Worker(不包括 Service Worker)中使用。
XMLHttpRequest
的 open()
方法會初始化一個新建立的請求,或重新初始化一個已存在的請求。
備註:
對於一個已啟動的請求(即 open()
已被呼叫過的請求)呼叫此方法,等同於呼叫 abort()
。
語法
open(method, url)
open(method, url, async)
open(method, url, async, user)
open(method, url, async, user, password)
參數
method
-
要使用的 HTTP 請求方法,例如
"GET"
、"POST"
、"PUT"
、"DELETE"
等。對於非 HTTP(S) 的 URL 會被忽略。 url
async
選擇性-
一個可選的布林參數,預設為
true
,表示是否要非同步執行操作。如果此值為false
,send()
方法在收到回應前不會回傳。如果為true
,則會使用事件監聽器來提供完成交易的通知。如果multipart
屬性為true
,此值必須為true
,否則將會拋出例外。備註: 在主執行緒上的同步請求很容易對使用者體驗造成干擾,應避免使用;事實上,許多瀏覽器已完全棄用在主執行緒上的同步 XHR 支援。在
Worker
中允許同步請求。 user
選擇性-
可選的使用者名稱,用於驗證;預設為
null
值。 password
選擇性-
可選的密碼,用於驗證;預設為
null
值。
回傳值
無(undefined
)。
規範
Specification |
---|
XMLHttpRequest # the-open()-method |