---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Rufen Sie „Anforderungsinitiit" ab -- Umfang, Global

# Rufen Sie „Anforderungsinitiit" ab -- Umfang, Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 Minuten Lesedauer

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

Sie können ein Anforderungs-Init-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 an beiden Stellen dieselbe Option 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 API-Sammlung umfasst:

* [Abrufen -- Abrufen (Zeichenfolgenressource, Objektoptionen)](https://servicenow-prod.fluidtopics.net/AwrAhKNGXaLxw1ZC79Ebww#fetch.fetch_S_O "Startet den Prozess des Abrufs einer Ressource aus dem Netzwerk und gibt eine Zusage zurück, die erfüllt wird, sobald die Antwort verfügbar ist."): Startet den Prozess zum Abrufen einer Ressource aus dem Netzwerk.
* [Header Abrufen -- Umfang, Global](https://servicenow-prod.fluidtopics.net/8xlkjooH2aJiEhCejNeIPA#Fetch.HeadersAPI "Die Header Abrufen Mit der API können Sie Header aus einer Liste von Anforderungs- oder Antwortheadern abrufen, festlegen, hinzufügen und entfernen."): Ruft Anforderungs- und Antwortheader ab und ändert sie.
* [Anforderung Abrufen -- Umfang, Global](https://servicenow-prod.fluidtopics.net/_IVSKGlRao8N9tpSmy34gw#Fetch.RequestAPI "Die Anforderung Abrufen API enthält Methoden zum Erstellen oder Abrufen eines Anforderungsobjekts, damit Anwendungen Ressourcen wie JSON, Text oder Binärdaten asynchron von einem Server anfordern können. und bearbeiten Sie die Antwort. Diese API unterstützt verschiedene HTTP-Methoden wie GET, POST, PUT, DELETE usw."): Erstellen Sie ein neues Anforderungsobjekt.
* [Rufen Sie „Anforderungsinitiit" ab -- Umfang, Global](https://servicenow-prod.fluidtopics.net/WVLdzExaUW_rqWMI7EaOzA#Fetch.RequestInitAPI "Die Anforderung initiieren Die API bietet Optionen zum Konfigurieren einer Abrufanforderung."): Legen Sie Optionen zum Konfigurieren einer Abrufanforderung fest.
* [Antwort Abrufen -- Umfang, Global](https://servicenow-prod.fluidtopics.net/25mxwH4S7LdH6buFK7jGEg#Fetch.ResponseAPI "Die Antwort Abrufen Die API bietet Methoden zum Erstellen eines neuen Antwortobjekts und zur Verarbeitung des von einem erstellten Antworttexts Anforderung Abrufen API-Methode."): Erstellen Sie ein neues Antwortobjekt.
{#Fetch.RequestInitAPI__ul_akb_fsf_pdc}

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. Für weitere Informationen zu `Glide.Hosts.Zulässigkeitsliste `, Siehe [Available system properties](https://www.servicenow.com/docs/access?context=r_AvailableSystemProperties&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).

## Anforderungsinitiit abrufen: Anforderungsinitiit {#ariaid-title2}

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

### Eigenschaften anfordern {#fetch.requestInit-requestInit__section_jcc_fdq_12c}

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 mögen `Umleiten `, `Referrer `, Und `Integrität `. Mit diesen Optionen können Sie das Anforderungsverhalten für verschiedene Anwendungsfälle optimieren. Ausführliche Erklärungen zu den einzelnen Eigenschaften finden Sie unter <https://developer.mozilla.org/en-US/docs/Web/API/RequestInit>.
{#fetch.requestInit-requestInit__table_t5x_2qw_jdc__entry__2}

| 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. {#fetch.requestInit-requestInit__ul_e4n_ljy_12c} 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 * TypenArray * URLSearchParameter {#fetch.requestInit-requestInit__ul_f4n_ljy_12c} |
| BrowsingTopics | Optional. Kennzeichnung, die angibt, ob die ausgewählten Themen für den aktuellen Anwender in einem Header „SEC-Browsing-Themen" 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-Themen" gesendet werden * Falsch: Ausgewählte Themen für den aktuellen Anwender dürfen nicht in einem Header „SEC-Browsing-Themen" gesendet werden. {#fetch.requestInit-requestInit__ul_nql_b3q_12c} Datentyp: Boolescher Wert |
| 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. * Force-Cache: 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 im Cache zu suchen, aktualisiert dann den Cache mit der heruntergeladenen Ressource. {#fetch.requestInit-requestInit__ul_g4n_ljy_12c} 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 einbeziehen, auch für Anforderungen mit Cross-Origin. Hinweis: Das Einbeziehen von Anmeldeinformationen in Anforderungen mit Cross-Origin kann eine Website angreifbar für CSRF-Angriffe machen, also auch wenn `Anmeldeinformationen `Ist auf festgelegt `Einbeziehen `, Der Server muss auch ihrer Aufnahme zustimmen, indem er die Zugriffssteuerung-Allow-Anmeldeinformationen in seine Antwort einbezieht. Außerdem muss der Server in dieser Situation explizit den Ursprung des Clients im Antwortheader „Zugriffssteuerung-Allow-Origin" angeben (d. h. `* `Ist nicht zulässig). * Auslassen: Senden Sie niemals Anmeldeinformationen in der Anforderung, oder fügen Sie Anmeldeinformationen in die Antwort ein. * Gleicher Ursprung: Nur Anmeldeinformationen für Anforderungen gleicher Herkunft senden und einschließen. {#fetch.requestInit-requestInit__ul_h4n_ljy_12c} Standard: Same-origin Datentyp: Zeichenfolge |
| headers | Optional. Alle Header, die Ihrer Anforderung hinzugefügt werden sollen, die in einem Headerobjekt 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 Hashens der Ressource mit dem angegebenen Hash-Algorithmus. {#fetch.requestInit-requestInit__ul_i4n_ljy_12c} 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. {#fetch.requestInit-requestInit__ul_j4n_ljy_12c} Datentyp: Boolescher Wert Standard: Falsch |
| 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 ursprungsübergreifend ist, wird der Mechanismus für die ursprungsübergreifende Ressourcenfreigabe (CORS) verwendet. In der Antwort werden nur CORS-Antwortheader mit sicherer Liste verfügbar gemacht. * 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 der Bereichsheader ebenfalls 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 `. {#fetch.requestInit-requestInit__ul_l4n_ljy_12c} * Navigieren: Wird nur von der HTML-Navigation verwendet. A `Navigieren `Anforderung wird nur beim Navigieren zwischen Dokumenten erstellt. {#fetch.requestInit-requestInit__ul_k4n_ljy_12c} 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. {#fetch.requestInit-requestInit__ul_m4n_ljy_12c} Datentyp: Zeichenfolge Standard: automatisch |
| 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: Gibt eine Antwort zurück, bei der fast alle Felder herausgefiltert sind, damit ein Service Worker die Antwort speichern und später wiedergeben kann. {#fetch.requestInit-requestInit__ul_n4n_ljy_12c} 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: * About: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 mit gleichem Ursprung: Legen Sie fest `Referrer `Header zum angegebenen Wert. Relative URLs werden relativ zur URL der Seite aufgelöst, die die Anforderung gestellt hat. {#fetch.requestInit-requestInit__ul_o4n_ljy_12c} 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 Abbruchsignal. Wenn diese Option festgelegt ist, kann die Anforderung durch Anruf abgebrochen werden Abbrechen() Auf dem entsprechenden `AbbruchController `. Datentyp: Zeichenfolge |
[Tabelle : 1. Eigenschaften anfordern]

{#fetch.requestInit-requestInit__table_t5x_2qw_jdc} {#fetch.requestInit-requestInit__table_mbs_ppw_jdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Rückgaben]

{#fetch.requestInit-requestInit__table_mbs_ppw_jdc}  

### 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 {#fetch.requestInit-requestInit__example_eg5_ckb_jdc}

Dieses Beispiel zeigt, wie Sie eine Anforderung erstellen und die Methoden-, Text- und Headeroptionen 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 sowohl an Anforderung() als auch an Abrufen() übergeben {#fetch.requestInit-requestInit__example_q3w_3kb_jdc}

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 Textkörper und Referrer-Optionen.  
In diesem Fall wird die Anforderung mit den folgenden Optionen gesendet:

* Methode: „POST"
* Header: {"Content-Type": "Application/JSON"}
* Textkörper: „{"username":"beispiel2"}"
* Referrer: „"
{#fetch.requestInit-requestInit__ul_zb4_qkb_jdc}

    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);
    }


