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)中使用。

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

一個字串或任何具有字串化器的其他物件(包括一個 URL 物件),提供了要傳送請求的資源的 URL。

async 選擇性

一個可選的布林參數,預設為 true,表示是否要非同步執行操作。如果此值為 falsesend() 方法在收到回應前不會回傳。如果為 true,則會使用事件監聽器來提供完成交易的通知。如果 multipart 屬性為 true,此值必須true,否則將會拋出例外。

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

user 選擇性

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

password 選擇性

可選的密碼,用於驗證;預設為 null 值。

回傳值

無(undefined)。

規範

Specification
XMLHttpRequest
# the-open()-method

瀏覽器相容性

參見