Rufen Sie „RequestInit“ ab – Umfang, Global

Die Anforderung initiieren Die API bietet Optionen zum Konfigurieren einer Abrufanforderung.

Sie können ein RequestInit-Objekt an übergeben Anforderung () Konstruktor oder direkt in Abrufen () Funktionsaufruf. Sie können eine Anforderung auch mit erstellen Anforderungsinitialisierung() Rufen Sie an, und übergeben Sie die Anforderung an einen Abrufen () Rufen Sie zusammen mit einem anderen an Anforderungsinitialisierung() . Wenn Sie dies tun, wenn dieselbe Option an beiden Stellen festgelegt ist, wird der Wert direkt an übergeben Abrufen () Wird verwendet.

Diese API ist Teil eines Satzes von Abrufen APIs, die verschiedene Aktionen zum Abrufen von Ressourcen von externen Websites bereitstellen. Der vollständige Abrufen Die API-Sammlung umfasst:

• Abrufen – Abrufen (Zeichenfolgenressource, Objektoptionen): Startet den Prozess des Abrufs einer Ressource aus dem Netzwerk.
• Header Abrufen – Umfang, Global: Anforderungs- und Antwortheader abrufen und ändern.
• Anforderung Abrufen – Umfang, Global: Erstellen Sie ein neues Anforderungsobjekt.
• Rufen Sie „RequestInit“ ab – Umfang, Global: Legen Sie Optionen zum Konfigurieren einer Abrufanforderung fest.
• Antwort Abrufen – Umfang, Global: Erstellen Sie ein neues Antwortobjekt.

Zur Unterstützung von Abrufaktionen die Systemeigenschaft Glide.Hosts.Zulässigkeitsliste , Ermöglicht Steuerungen darüber, auf welche Hosts eine Abrufmethode zugreifen kann. Dies gilt für HTTP-APIs wie RestMessageV2 und die oben genannten. Weitere Informationen zu finden Glide.Hosts.Zulässigkeitsliste , Siehe Available system properties.

RequestInit abrufen: RequestInit

Legen Sie Optionen zum Konfigurieren einer Abrufanforderung fest. Sie können ein RequestInit-Objekt an übergeben Anforderung () Konstruktor oder direkt in Abrufen () Funktionsaufruf.

Eigenschaften von „RequestInit“

Die Anforderung initiieren Die API unterstützt mehrere optionale Eigenschaften, die zum Konfigurieren des HTTP-Anforderungsverhaltens verwendet werden können. Zu seinen Eigenschaften gehören Methode (HTTP-Methode), Header (Anforderungsheader), Textkörper (Zu sendende Daten), Modus (CORS-Modus), Anmeldeinformationen (Authentifizierungsdetails), Cache (Cache-Verhalten) und andere wie Umleiten , Referrer , Und Integrität . Mit diesen Optionen können Sie das Anforderungsverhalten für verschiedene Anwendungsfälle optimieren. Weitere ausführliche Erklärungen zu den einzelnen Eigenschaften finden Sie unter https://developer.mozilla.org/en-US/docs/Web/API/RequestInit.

Tabelle : 1. Eigenschaften von „RequestInit“

Eigenschaftsname	Beschreibung
AttributionReporting	Optional. Gibt an, dass die Antwort der Anforderung eine JavaScript-basierte Attributionsquelle oder einen Attributionsauslöser registrieren soll. AttributionReporting Ist ein Objekt mit den folgenden Eigenschaften: EventSourceElisible: Boolescher Wert. Wenn auf festgelegt Wahr , Die Antwort der Anforderung ist berechtigt, eine Attributionsquelle zu registrieren. Wenn auf festgelegt Falsch , Ist nicht für die Registrierung als Attributionsquelle berechtigt. TriggerElisible: Boolescher Wert. Wenn auf festgelegt Wahr , Die Antwort der Anforderung ist berechtigt, einen Attributionsauslöser zu registrieren. Wenn auf festgelegt Falsch , Ist nicht für die Registrierung als Attributionsauslöser berechtigt. Datentyp: Objekt
body	Optional. Der Anforderungstext enthält Inhalte, die an den Server gesendet werden sollen, z. B. in einem POST oder einer PUT-Anforderung. Akzeptierte Typen: ArrayBuffer Eine Zeichenfolge Blob Datenansicht Datei FormData Schreibbarer Stream TypedArray URLSearchParams
BrowsingTopics	Optional. Kennzeichnung, die angibt, ob die ausgewählten Themen für den aktuellen Anwender in einem Header „SEC-Browsing-Topics“ mit der zugehörigen Anforderung gesendet werden sollen. Akzeptierte Werte: Wahr: Ausgewählte Themen für den aktuellen Anwender müssen in einem Header „SEC-Browsing-Topics“ gesendet werden Falsch: Ausgewählte Themen für den aktuellen Anwender dürfen nicht in einem SEC-Browsing-Topics-Header gesendet werden. Datentyp: Boolesch
Cache	Optional. Der für die Anforderung zu verwendende Cache-Modus. Akzeptierte Werte: Standard: Der Browser sucht in seinem HTTP-Cache nach einer Antwort, die der Anforderung entspricht. Cache erzwingen: Der Browser sucht in seinem HTTP-Cache nach einer Antwort, die der Anforderung entspricht. Kein Cache: Der Browser sucht in seinem HTTP-Cache nach einer Antwort, die der Anforderung entspricht. Kein Speicher: Der Browser ruft die Ressource vom Remote-Server ab, ohne zuerst im Cache zu suchen, und aktualisiert den Cache nicht mit der heruntergeladenen Ressource. Nur wenn zwischengespeichert: Der Browser sucht in seinem HTTP-Cache nach einer Antwort, die der Anforderung entspricht. Neu laden: Der Browser ruft die Ressource vom Remote-Server ab, ohne zuerst den Cache zu suchen, aktualisiert dann den Cache mit der heruntergeladenen Ressource. Die Nur-wenn-zwischengespeichert Der Modus kann nur verwendet werden, wenn der Modus der Anforderung lautet Gleicher Ursprung . Zwischengespeicherte Umleitungen werden befolgt, wenn die Anforderung lautet Umleiten Eigenschaft ist Folgen Und die Umleitungen verletzen nicht Gleicher Ursprung Modus. Datentyp: Zeichenfolge
Anmeldeinformationen	Optional. Steuert, ob der Browser Anmeldeinformationen mit der Anforderung sendet und ob Antwortheader für „Set-Cookie“ berücksichtigt werden. Anmeldeinformationen sind Cookies, TLS-Clientzertifikate oder Authentifizierungsheader, die einen Anwendernamen und ein Passwort enthalten. Akzeptierte Werte: Einbeziehen: Anmeldeinformationen immer einschließen, auch für Anforderungen mit unterschiedlichen Ursprung. Hinweis: Durch das Einbeziehen von Anmeldeinformationen in urheberübergreifende Anforderungen kann eine Website angreifbar für CSRF-Angriffe werden, also auch wenn Anmeldeinformationen Ist auf festgelegt Einbeziehen , Der Server muss auch ihrer Aufnahme zustimmen, indem er Access-Control-allow-Credentials in seine Antwort einbezieht. Darüber hinaus muss der Server in dieser Situation den Ursprung des Clients explizit im Antwortheader „Zugriffssteuerung-Allow-Origin“ angeben (d. h. * Ist nicht zulässig). Auslassen: Senden Sie keine Anmeldeinformationen in die Anforderung, oder fügen Sie Anmeldeinformationen in die Antwort ein. Gleicher Ursprung: Nur Anmeldeinformationen für Anforderungen gleicher Herkunft senden und einschließen. Standard: Same-Origin Datentyp: Zeichenfolge
headers	Optional. Alle Header, die Ihrer Anforderung hinzugefügt werden sollen, die in einem Header-Objekt oder einem Objektliteral enthalten sind, dessen Schlüssel die Namen von Headern sind und deren Werte die Headerwerte sind. Viele Header werden automatisch vom Browser festgelegt und können nicht von einem Skript festgelegt werden. Diese werden als verbotene Headernamen bezeichnet. Wenn Modus Option ist auf festgelegt Keine cors , Sie können nur CORS-Anforderungsheader mit sicherer Liste festlegen. Datentyp: Zeichenfolge
Integrität	Optional. Enthält den Integritätswert der Unterressource der Anforderung. Dies wird aktiviert, wenn die Ressource abgerufen wird. Der Browser berechnet den Hash der abgerufenen Ressource mit dem angegebenen Algorithmus. Wenn das Ergebnis nicht mit dem angegebenen Wert übereinstimmt, lehnt der Browser die Abrufanforderung mit einem Netzwerkfehler ab. Das Format dieser Option ist <hash-algo>-<hash-source> Wobei: <hash-algo>: Ist einer der folgenden Werte: sha256, sha384 oder sha512. <hash-source>: Ist die Base64-Codierung des Ergebnisses des Hashings der Ressource mit dem angegebenen Hash-Algorithmus. Standardmäßig wird eine leere Zeichenfolge verwendet. Datentyp: Zeichenfolge
Keepalive	Optional. Kennzeichnung, die angibt, ob die zugehörige Anforderung abgebrochen werden soll, wenn die Seite, die sie initiiert hat, entladen wird, bevor die Anforderung abgeschlossen ist. Die Textgröße für Keepalive Anforderungen sind auf 64 Kibibytes beschränkt. Gültige Werte: Wahr: Der Browser bricht die zugehörige Anforderung nicht ab. Falsch: Bricht die zugehörige Anforderung ab. Datentyp: Boolesch Standardwert: false
method	Optional. Die Anforderungsmethode. Datentyp: Zeichenfolge Standard: GET
Modus	Optional. Legt das ursprungsübergreifende Verhalten für die Anforderung fest. Gültige Werte: Gleicher Ursprung: Erlaubt nicht ursprungsübergreifende Anforderungen. Wenn ein Gleicher Ursprung Anforderung wird an einen anderen Ursprung gesendet. Das Ergebnis ist ein Netzwerkfehler. cors: Wenn die Anforderung Cross-Origin Resource Sharing (CORS)-Mechanismus (Cross-Origin Resource Sharing) verwendet wird. In der Antwort sind nur CORS-Antwortheader mit sicherer Liste verfügbar. No-cors: Deaktiviert CORS für ursprungsübergreifende Anforderungen. Diese Option enthält die folgenden Einschränkungen: Die Methode darf nur eine von sein KOPF , ABRUFEN Oder VERÖFFENTLICHEN . Die Header dürfen nur CORS-Anforderungsheader mit sicherer Liste sein, mit der zusätzlichen Einschränkung, dass auch der Bereichsheader nicht zulässig ist. Dies gilt auch für alle Header, die von Service Worker hinzugefügt wurden. Die Antwort ist undurchsichtig, was bedeutet, dass die Header und der Textkörper nicht für JavaScript verfügbar sind und ihr Statuscode immer lautet 0 . Navigieren: Wird nur von HTML-Navigation verwendet. A Navigieren Anforderung wird nur beim Navigieren zwischen Dokumenten erstellt. Datentyp: Zeichenfolge Standard: cors
Priorität	Optional. Gibt die Priorität der Abrufanforderung im Vergleich zu anderen Anforderungen desselben Typs an. Gültige Werte: automatisch: Keine Anwendereinstellung für die Abrufpriorität. Wird verwendet, wenn kein Wert festgelegt ist oder wenn ein ungültiger Wert festgelegt ist. Hoch: Eine Abrufanforderung mit hoher Priorität im Vergleich zu anderen Anforderungen desselben Typs. Niedrig: Eine Abrufanforderung mit niedriger Priorität im Vergleich zu anderen Anforderungen desselben Typs. Datentyp: Zeichenfolge Standard: auto
umleiten	Optional. Bestimmt das Verhalten des Browsers, falls der Server mit einem Umleitungsstatus antwortet. Akzeptierte Werte: Folgen: Umleitungen automatisch verfolgen. Fehler: Lehnen Sie die Zusage mit einem Netzwerkfehler ab, wenn ein Umleitungsstatus zurückgegeben wird. Manuell: Geben Sie eine Antwort zurück, bei der fast alle Felder herausgefiltert sind, damit ein Servicemitarbeiter die Antwort speichern und später wiedergeben kann. Datentyp: Zeichenfolge Standard: Folgen
Referrer	Optional. Eine Zeichenfolge, die den Wert angibt, der für den Referrer-Header der Anforderung verwendet werden soll. Akzeptierte Werte und Datentypen: Info:Client: Legen Sie fest Referrer Header zum Standardwert für den Kontext der Anforderung (z. B. die URL der Seite, die die Anforderung gestellt hat). Leere Zeichenfolge: Auslassen Referrer Header. Relative oder absolute URL des gleichen Ursprungs: Legen Sie fest Referrer Header für den angegebenen Wert. Relative URLs werden relativ zur URL der Seite aufgelöst, die die Anforderung gestellt hat. Standard: About:Client
ReferrerPolicy	Optional. Eine Zeichenfolge, die eine Richtlinie für den Referrer-Header festlegt. Die Syntax und Semantik dieser Option sind genau identisch mit dem Header „Referrer-Policy“. Datentyp: Zeichenfolge
signal	Optional. Ein AbortSignal. Wenn diese Option festgelegt ist, kann die Anforderung durch Anruf abgebrochen werden Abbruch() Auf dem entsprechenden AbortController . Datentyp: Zeichenfolge

Tabelle : 2. Rückgaben

Typ	Beschreibung
Keine

Optionen an FETCH() übergeben

Dieses Beispiel zeigt, wie die Optionen für Methode, Text und Header direkt an übergeben werden Abrufen () Methode:

async function post() {
  const response = await fetch("https://example.org/post", {
    method: "POST",
    body: JSON.stringify({ username: "example" }),
    headers: {
      "Content-Type": "application/json",
    },
  });

  console.log(response.status);
}

Übergeben Sie Optionen an den Request()-Konstruktor

Dieses Beispiel zeigt, wie Sie eine Anforderung erstellen und die Optionen für Methode, Text und Header an den Konstruktor übergeben und die Anforderung an übergeben Abrufen () :

async function post() {
  const request = new Request("https://example.org/post", {
    method: "POST",
    body: JSON.stringify({ username: "example" }),
    headers: {
      "Content-Type": "application/json",
    },
  });

  const response = await fetch(request);

  console.log(response.status);
}

Optionen an Request() und fetch() übergeben

Dieses Beispiel zeigt HO zum Erstellen von Anforderung () Und übergeben Sie die Optionen für Methode, Text und Header an den Konstruktor. Das Skript übergibt die Anforderung dann an Abrufen () Zusammen mit den Optionen „Text“ und „Referrer“.

In diesem Fall wird die Anforderung mit den folgenden Optionen gesendet:

• Methode: „POST“
• Header: {"Content-Type": "Application/JSON"}
• Textkörper: „{"username":"beispiel2"}"
• Referrer: „“

async function post() {
  const request = new Request("https://example.org/post", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ username: "example1" }),
  });

  const response = await fetch(request, {
    body: JSON.stringify({ username: "example2" }),
    referrer: "",
  });

  console.log(response.status);
}