XMLHttpRequest: open() メソッド
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-
文字列または文字列化のあるその他のオブジェクト、例えば
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
関連情報
- XMLHttpRequest の使用
- 関連する
XMLHttpRequestのメソッド:setRequestHeader(),send(),abort()