XMLHttpRequest: send()-Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von Service Workers.

Die XMLHttpRequest-Methode send() sendet die Anfrage an den Server.

Wenn die Anfrage asynchron ist (was der Standard ist), kehrt diese Methode zurück, sobald die Anfrage gesendet wurde und das Ergebnis wird über Ereignisse geliefert. Ist die Anfrage synchron, kehrt diese Methode nicht zurück, bis die Antwort eingetroffen ist.

send() akzeptiert einen optionalen Parameter, mit dem Sie den Inhalt der Anfrage angeben können; dies wird hauptsächlich für Anfragen wie PUT verwendet. Wenn die Anfragemethode GET oder HEAD ist, wird der body-Parameter ignoriert und der Anfragetext auf null gesetzt.

Wenn kein Accept-Header mithilfe von setRequestHeader() gesetzt wurde, wird ein Accept-Header mit dem Typ "*/*" (jeder Typ) gesendet.

In diesem Artikel

Syntax

js
send()
send(body)

Parameter

body Optional

Ein Datenkörper, der in der XHR-Anfrage gesendet werden soll. Dies kann sein:

Ein Document, das vor dem Senden serialisiert wird.
Ein XMLHttpRequestBodyInit, das laut Fetch-Spezifikation ein Blob, ein ArrayBuffer, ein TypedArray, ein DataView, ein FormData, ein URLSearchParams oder ein String sein kann.
null

Wenn kein Wert für den Body angegeben wird, wird standardmäßig null verwendet.

Der beste Weg, um binäre Inhalte (z.B. bei Datei-Uploads) zu senden, ist die Verwendung eines TypedArray, eines DataView oder eines Blob-Objekts in Verbindung mit der send()-Methode.

Rückgabewert

Keiner (undefined).

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn send() bereits für die Anfrage aufgerufen wurde und/oder die Anfrage abgeschlossen ist.

NetworkError DOMException

Wird ausgelöst, wenn der abzurufende Ressourcentyp ein Blob ist und die Methode nicht GET ist.

Beispiel: GET

js
const xhr = new XMLHttpRequest();
xhr.open("GET", "/server", true);

xhr.onload = () => {
  // Request finished. Do processing here.
};

xhr.send(null);
// xhr.send('string');
// xhr.send(new Blob());
// xhr.send(new Int8Array());
// xhr.send(document);

Beispiel: POST

js
const xhr = new XMLHttpRequest();
xhr.open("POST", "/server", true);

// Send the proper header information along with the request
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");

xhr.onreadystatechange = () => {
  // Call a function when the state changes.
  if (xhr.readyState === XMLHttpRequest.DONE && xhr.status === 200) {
    // Request finished. Do processing here.
  }
};
xhr.send("foo=bar&lorem=ipsum");
// xhr.send(new Int8Array());
// xhr.send(document);

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

XMLHttpRequest API
XMLHttpRequest
Konstruktor
1. XMLHttpRequest()
Instanzeigenschaften
Instanzmethoden
Events
1. readystatechange
Vererbung
1. XMLHttpRequestEventTarget
2. EventTarget
Verwandte Seiten für XMLHttpRequest API
Anleitungen
1. Verwendung von XMLHttpRequest
2. HTML in XMLHttpRequest
3. Synchrone und asynchrone Anfragen
4. Senden und Empfangen von Binärdaten
5. Verwenden von FormData-Objekten