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

瀏覽器相容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
open

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

參見