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.

XMLHttpRequestopen() 方法用來初始化新建立的請求,或重新初始化現有請求。

備註:為已啟動(已經呼叫 open())的請求呼叫此方法,相當於呼叫 abort()

語法

js
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

字串或任何其他帶有 stringifier 的物件──包括 URL 物件──提供要向其發送請求的資源的 URL。

async 選擇性

選擇性布林參數,表示是否非同步執行操作,預設為 true。如果該值為 false,則 send() 方法在收到回應之前不會傳回。如果為 true,則使用事件監聽器提供交易完成的通知。如果 multipart 屬性為 true,則該值必須為 true,否則將引發例外。

備註:主執行緒上的同步請求很容易破壞使用者體驗,應該避免;事實上,許多瀏覽器已經完全棄用了主執行緒上的同步 XHR 支援。 Worker 中允許同步請求。

user 選擇性

選擇性參數,用於身份驗證的用戶名;預設值為 null

password 選擇性

選擇性參數,用於身份驗證的密碼;預設值為 null

回傳值

無(undefined)。

規範

Specification
XMLHttpRequest Standard
# the-open()-method

瀏覽器相容性

BCD tables only load in the browser

參見