XMLHttpRequest: open() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

注意:此功能在 Web Workers 中可用,但 Service Workers 除外。

XMLHttpRequest 方法 open() 初始化一個新建立的請求,或者重新初始化一個已有的請求。

注意: 對一個已啟用的請求(即已經呼叫過 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

一個字串或任何其他具有 字串轉換器的物件 — 包括 URL 物件 — 該物件提供要將請求傳送到的資源的 URL。

async 可選

一個可選的布林值引數,預設為 true,指示操作是否以非同步方式執行。如果此值為 false,則 send() 方法在收到響應之前不會返回。如果為 true,則使用事件監聽器提供事務完成的通知。如果 multipart 屬性為 true,此值必須true,否則將丟擲異常。

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

user 可選

用於身份驗證的可選使用者名稱;預設值為 null

password 可選

用於身份驗證的可選密碼;預設值為 null

返回值

無(undefined)。

規範

規範
XMLHttpRequest
# the-open()-method

瀏覽器相容性

另見