---
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


---

# Header Abrufen -- Umfang, Global

# Header Abrufen -- Umfang, Global {#ariaid-title1}

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

Die Header Abrufen Mit der API können Sie Header aus einer Liste von Anforderungs- oder Antwortheadern abrufen, festlegen, hinzufügen und entfernen.  
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.HeadersAPI__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).

## Header abrufen -- Header (init) {#ariaid-title2}

Die Header() Der Konstruktor erstellt ein neues, leeres Header-Objekt. Sie können auch ein neues Header-Objekt mit einer Liste von HTTP-Headern erstellen und vorab ausfüllen, indem Sie verwenden initParameter.
Hinweis:  
Verwenden Sie zum Hinzufügen von Headern zu einem vorhandenen Headerobjekt [Header abrufen -- append(Zeichenfolgenname, Zeichenfolgenwert)](https://servicenow-prod.fluidtopics.net/8xlkjooH2aJiEhCejNeIPA#fetch.headers-append_S_S "Fügt einem vorhandenen Header in einem Header-Objekt einen neuen Wert hinzu, oder fügt den Header hinzu, falls er noch nicht vorhanden ist.").
{#fetch.headers-constructor__table_nzn_3rv_gdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Init | Objekt | Optional. Ein Objektliteral mit HTTP-Headern, mit denen das neue Headerobjekt vorab ausgefüllt werden soll. Gültige Werte: * Ein Objektliteral mit Zeichenfolgenwerten, * Ein Array von Name-Wert-Paaren, * Ein vorhandenes Header-Objekt (in dem das neue Objekt Daten aus dem vorhandenen Objekt kopiert). Standard: Erstellt ein leeres Header-Objekt |
[Tabelle : 1. Parameter]

{#fetch.headers-constructor__table_nzn_3rv_gdc}  
Das folgende Beispiel zeigt, wie verwendet wird Header() Konstruktor zum Erstellen eines neuen Headerobjekts mit und ohne Header.

    //Intializes an empty Headers object.
    var headers = new Headers();

    //Sets the new Headers object with a list of headers.
    var httpHeaders = {
      "Content-Type": "application/json", 
      "X-My-Custom-Header": "XYZ", 
    }; 

    var myHeaders = new Headers(httpHeaders);

## Header abrufen -- append(Zeichenfolgenname, Zeichenfolgenwert) {#ariaid-title3}

Fügt einem vorhandenen Header in einem Header-Objekt einen neuen Wert hinzu, oder fügt den Header hinzu, falls er noch nicht vorhanden ist.
Wenn der angegebene Header bereits vorhanden ist, `Anfügen() `Ändert den vorhandenen Wert in den angegebenen Wert. Wenn der angegebene Header bereits vorhanden ist und mehrere Werte akzeptiert, `Anfügen() `Hängt den neuen Wert an das Ende des Wertsatzes an. Verwenden Sie, um den alten Wert mit einem neuen zu überschreiben [Header abrufen -- Set (Zeichenfolgenname, Zeichenfolgenwert)](https://servicenow-prod.fluidtopics.net/8xlkjooH2aJiEhCejNeIPA#fetch.headers-set_S_S "Aktualisiert einen Wert eines vorhandenen Headers im Header-Objekt oder erstellt einen neuen Header mit dem angegebenen Wert, wenn der Header noch nicht vorhanden ist.").
{#fetch.headers-append_S_S__table_kpj_czp_jdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Erforderlich. Der Name des HTTP-Headers, der dem Header-Objekt hinzugefügt werden soll. |
| Wert | Zeichenfolge | Erforderlich. Der Wert des hinzuzufügenden HTTP-Headers. |
[Tabelle : 2. Parameter]

{#fetch.headers-append_S_S__table_kpj_czp_jdc} {#fetch.headers-append_S_S__table_lpj_czp_jdc__entry__2}

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

{#fetch.headers-append_S_S__table_lpj_czp_jdc}  
Das folgende Beispiel zeigt, wie Sie einen Header mit hinzufügen Anfügen() :

    var myHeaders = new Headers(); // Currently empty
    myHeaders.append("Content-Type", "image/jpeg");
    myHeaders.get("Content-Type"); // Returns 'image/jpeg'

Ausgabe:

    "image/jpeg"

Das folgende Beispiel zeigt, wie ein neuer Header angehängt wird, der mehrere Werte akzeptiert:

    var myHeaders = new Headers(); // Currently empty
    myHeaders.append("Accept-Encoding", "deflate");
    myHeaders.append("Accept-Encoding", "gzip");
    myHeaders.get("Accept-Encoding"); // Returns 'deflate, gzip'

Ausgabe:

    {"deflate", "gzip"} 

## Header abrufen -- DELETE (Zeichenfolgenname) {#ariaid-title4}

Löscht einen Header aus dem aktuellen Header-Objekt.
{#fetch.headers-delete_S__table_zpr_f1q_jdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Der Name des HTTP-Headers, der aus dem Header-Objekt gelöscht werden soll. |
[Tabelle : 4. Parameter]

{#fetch.headers-delete_S__table_zpr_f1q_jdc} {#fetch.headers-delete_S__table_aqr_f1q_jdc__entry__2}

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

{#fetch.headers-delete_S__table_aqr_f1q_jdc}  
Das folgende Beispiel zeigt, wie Sie dem Header-Objekt zuerst mit einen Header hinzufügen Anfügen() , Und löschen Sie dann denselben Header mit Löschen() .

    var myHeaders =newHeaders();// Currently empty
    myHeaders.append("Content-Type","image/jpeg");
    myHeaders.get("Content-Type");// Returns 'image/jpeg'

Das folgende Beispiel zeigt, dass der Endpunkt einen Wert von Null zurückgibt, wenn das Headerobjekt bereits gelöscht ist:

    myHeaders.delete("Content-Type");
    myHeaders.get("Content-Type");// Returns null, as it has been deleted

Ausgabe:

    null

## Header abrufen -- Einträge() {#ariaid-title5}

Gibt einen Iterator zurück, mit dem Sie alle Schlüssel-Wert-Paare (dargestellt durch Zeichenfolgen) durchlaufen können, die im Header-Objekt enthalten sind.
{#fetch.headers-entries__table_es2_fbq_jdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 6. Parameter]

{#fetch.headers-entries__table_es2_fbq_jdc} {#fetch.headers-entries__table_fs2_fbq_jdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Iterator | Gibt ein Iteratorobjekt zurück, bei dem sowohl die Schlüssel- als auch die Wertpaare Zeichenfolgenobjekte sind. |
[Tabelle : 7. Rückgaben]

{#fetch.headers-entries__table_fs2_fbq_jdc}  
Das folgende Beispiel zeigt, wie ein Test-Header-Objekt erstellt und dann verwendet wird Einträge() Methode zum Rückgeben eines Iterators aller Werte im Header-Objekt.

    // Create a test Headers object
    var myHeaders = new Headers();
    myHeaders.append("Content-Type", "text/xml");
    myHeaders.append("Vary", "Accept-Language");

    // Display the key/value pairs
    for (var pair of myHeaders.entries()) {
      console.log(`${pair[0]}: ${pair[1]}`);
    }

Ausgabe:

    content-type: text/xml
    vary: Accept-Language

## Header abrufen -- forEach(function callbackFn, Object thisArg) {#ariaid-title6}

Führt eine Rückruffunktion einmal pro Schlüssel-Wert-Paar im Header-Objekt aus.
Die Rückruffunktion wird nicht für gelöschte Schlüssel ausgeführt, sondern für vorhandene Schlüssel, auch wenn der Wert nicht definiert ist.
{#fetch.headers-forEach_O_S__table_pjv_xcq_jdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| CallbackFn | Funktion | Funktion, die für jedes Schlüssel-Wert-Paar im Header-Objekt ausgeführt werden soll. Entspricht dem folgenden Format: `CallbackFn(Zeichenfolgenschlüssel, Zeichenfolgenwert) `. |
| CallbackFn.value | Zeichenfolge | Wert des Headereintrags. |
| callbackFn.key | Zeichenfolge | Name des Headereintrags. |
| CallBackFn.object | Header | Das zu iterierende Header-Objekt. |
| DisArg | Objekt | Wert, der als verwendet werden soll `Dies `Beim Ausführen `Rückruf `. |
[Tabelle : 8. Parameter]

{#fetch.headers-forEach_O_S__table_pjv_xcq_jdc} {#fetch.headers-forEach_O_S__table_qjv_xcq_jdc__entry__2}

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

{#fetch.headers-forEach_O_S__table_qjv_xcq_jdc}  
Das folgende Beispiel protokolliert eine Zeile für jedes Schlüssel-Wert-Paar im Header-Objekt:

    // Create a new test Headers object
    var myHeaders = new Headers();
    myHeaders.append("Content-Type", "application/json");
    myHeaders.append("Cookie", "This is a demo cookie");
    myHeaders.append("compression", "gzip");

    // Display the key/value pairs
    myHeaders.forEach((value, key) => {
      console.log(`${key} ==> ${value}`);
    });

Ausgabe:

    compression ==> gzip
    content-type ==> application/json
    cookie ==> This is a demo cookie

## Header abrufen -- GET(Zeichenfolgenname) {#ariaid-title7}

Gibt eine Zeichenfolge aller Headerwerte eines angegebenen Headerobjekts zurück oder gibt Null zurück, wenn der Header nicht vorhanden ist.
{#fetch.headers-get_S__table_lg2_kfq_jdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Der Name des HTTP-Headers, dessen Headerwerte Sie abrufen möchten (Groß-/Kleinschreibung wird nicht beachtet). |
[Tabelle : 10. Parameter]

{#fetch.headers-get_S__table_lg2_kfq_jdc} {#fetch.headers-get_S__table_mg2_kfq_jdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Wert des abgerufenen Headers (dargestellt als Zeichenfolge) oder Null, wenn der Header nicht festgelegt ist. Gibt einen Fehler zurück, wenn der Header nicht vorhanden ist. Gibt einen Typfehler zurück, wenn der angegebene Name nicht der eines HTTP-Headers ist. |
[Tabelle : 11. Rückgaben]

{#fetch.headers-get_S__table_mg2_kfq_jdc}  
Im Folgenden wird gezeigt, wie Sie ein Header-Objekt mit mehreren Headern mit erstellen Anfügen() , Und gibt dann die Werte des Headers mit zurück Get() Methode.

    var myHeaders = new Headers(); // Currently empty
    myHeaders.append("Accept-Encoding", "deflate");
    myHeaders.append("Accept-Encoding", "gzip");
    myHeaders.get("Accept-Encoding"); // Returns "deflate, gzip"
    myHeaders
      .get("Accept-Encoding")
      .split(",")
      .map((v) => v.trimStart()); // Returns [ "deflate", "gzip"

Ausgabe:

    [ "deflate", "gzip" ]

## Header abrufen -- getSetCookie() {#ariaid-title8}

Gibt alle Set-Cookie-Header zurück, die einer Antwort zugeordnet sind.
{#fetch.headers-getSetCookie__table_spp_hgq_jdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 12. Parameter]

{#fetch.headers-getSetCookie__table_spp_hgq_jdc} {#fetch.headers-getSetCookie__table_tpp_hgq_jdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Array von Zeichenfolgen | Ein Array von Zeichenfolgen, das die Werte aller Set-Cookie-Header enthält, die einer Antwort zugeordnet sind. Die Methode gibt ein leeres Array zurück, wenn keine Set-Cookie-Header festgelegt sind. |
[Tabelle : 13. Rückgaben]

{#fetch.headers-getSetCookie__table_tpp_hgq_jdc}  
Das folgende Skriptbeispiel zeigt die Verwendung GetSetCookie() So geben Sie die Headerwerte zurück, die der Antwort zugeordnet sind:

    var headers = new Headers({
      "Set-Cookie": "name1=value1",
    });

    headers.append("Set-Cookie", "name2=value2");

    headers.getSetCookie();

Ausgabe:

    ["name1=value1", "name2=value2"]

## Header abrufen -- hat(Zeichenfolgenname) {#ariaid-title9}

Gibt einen booleschen Wert zurück, der angibt, ob ein Header-Objekt den angegebenen Header enthält.
{#fetch.headers-has_S__table_bvr_r3q_jdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Der Name des HTTP-Headers, um zu überprüfen, ob er im Header-Objekt vorhanden ist oder nicht. |
[Tabelle : 14. Parameter]

{#fetch.headers-has_S__table_bvr_r3q_jdc} {#fetch.headers-has_S__table_cvr_r3q_jdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der angegebene Header im Header-Objekt vorhanden ist. Ein TypeError wird zurückgegeben, wenn der angegebene Header kein gültiger HTTP-Headername ist. Mögliche Werte: * Wahr: Der Header ist im Objekt vorhanden. * Falsch: Der Header ist im Objekt nicht vorhanden. {#fetch.headers-has_S__ul_om2_lkq_jdc} |
[Tabelle : 15. Rückgaben]

{#fetch.headers-has_S__table_cvr_r3q_jdc}  
Im folgenden Beispiel wird verwendet Header() Und Anfügen() Methoden zum Erstellen und Festlegen eines Headerobjekts mit dem Inhaltstyp-Header. Das Beispiel verwendet dann Hat() Methode zum Anzeigen, dass der Inhaltstyp-Header im Header-Objekt vorhanden ist, ein Header für Akzeptanzcodierung jedoch nicht.

    var myHeaders = new Headers(); // Currently empty
    myHeaders.append("Content-Type", "image/jpeg");
    myHeaders.has("Content-Type"); // Returns true
    myHeaders.has("Accept-Encoding"); // Returns false

Ausgabe:

    true
    false

## Header abrufen -- Keys() {#ariaid-title10}

Gibt einen Iterator zurück, mit dem Sie alle Schlüssel durchlaufen können, die in einem Header-Objekt enthalten sind.
Verwenden Sie [Header abrufen -- values()](https://servicenow-prod.fluidtopics.net/8xlkjooH2aJiEhCejNeIPA#fetch.headers-values "Gibt einen Iterator zurück, mit dem Sie alle Headerwerte durchlaufen können, die im Headerobjekt enthalten sind.")Methode zum Rückgeben aller Header-Schlüssel.
{#fetch.headers-keys__table_hql_jmq_jdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 16. Parameter]

{#fetch.headers-keys__table_hql_jmq_jdc} {#fetch.headers-keys__table_iql_jmq_jdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Iterator | Gibt einen Iterator zurück, bei dem Header-Schlüssel als Zeichenfolgen dargestellt werden. |
[Tabelle : 17. Rückgaben]

{#fetch.headers-keys__table_iql_jmq_jdc}  
Das folgende Beispiel zeigt, wie ein Header-Objekt mit Schlüsseln erstellt und dann verwendet wird Schlüssel() Methode zum Rückgeben einer Liste der verfügbaren Header.

    // Create a test Headers object
    var myHeaders = new Headers();
    myHeaders.append("Content-Type", "text/xml");
    myHeaders.append("Vary", "Accept-Language");

    // Display the keys
    for (var key of myHeaders.keys()) {
      console.log(key);
    }

Ausgabe:

    content-type
    vary

## Header abrufen -- Set (Zeichenfolgenname, Zeichenfolgenwert) {#ariaid-title11}

Aktualisiert einen Wert eines vorhandenen Headers im Header-Objekt oder erstellt einen neuen Header mit dem angegebenen Wert, wenn der Header noch nicht vorhanden ist.
Um einfach einen neuen Wert an einen vorhandenen Header anzuhängen, ohne Daten zu überschreiben, verwenden Sie [Header abrufen -- append(Zeichenfolgenname, Zeichenfolgenwert)](https://servicenow-prod.fluidtopics.net/8xlkjooH2aJiEhCejNeIPA#fetch.headers-append_S_S "Fügt einem vorhandenen Header in einem Header-Objekt einen neuen Wert hinzu, oder fügt den Header hinzu, falls er noch nicht vorhanden ist.")Methode.
{#fetch.headers-set_S_S__table_q1b_1nq_jdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Der Name des HTTP-Headers, in dem ein neuer Wert festgelegt werden soll. Löst TypeError aus, wenn der angegebene Name nicht der Name eines HTTP-Headers ist. |
| Wert | Zeichenfolge | Der neue Wert, der für den angegebenen Header festgelegt werden soll. |
[Tabelle : 18. Parameter]

{#fetch.headers-set_S_S__table_q1b_1nq_jdc} {#fetch.headers-set_S_S__table_r1b_1nq_jdc__entry__2}

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

{#fetch.headers-set_S_S__table_r1b_1nq_jdc}  
Das folgende Beispiel zeigt, wie ein Header in einem neuen Header-Objekt mit festgelegt wird Anfügen() , Und setzen Sie dann den Wert mit zurück Satz() .

    var myHeaders = new Headers(); // Currently empty
    myHeaders.append("Content-Type", "image/jpeg");
    myHeaders.set("Content-Type", "text/html");

Ausgabe:

    text/html

Das folgende Beispiel zeigt, wie ein Wert in einem Header-Objekt festgelegt wird, wenn mehrere Werte akzeptiert werden:

    myHeaders.set("Accept-Encoding", "deflate");
    myHeaders.set("Accept-Encoding", "gzip");
    myHeaders.get("Accept-Encoding");

Ausgabe:

    gzip

## Header abrufen -- values() {#ariaid-title12}

Gibt einen Iterator zurück, mit dem Sie alle Headerwerte durchlaufen können, die im Headerobjekt enthalten sind.
Verwenden Sie [Header abrufen -- Keys()](https://servicenow-prod.fluidtopics.net/8xlkjooH2aJiEhCejNeIPA#fetch.headers-keys "Gibt einen Iterator zurück, mit dem Sie alle Schlüssel durchlaufen können, die in einem Header-Objekt enthalten sind.")Methode zum Rückgeben aller Headerwerte.
{#fetch.headers-values__table_s1w_r4q_jdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 20. Parameter]

{#fetch.headers-values__table_s1w_r4q_jdc} {#fetch.headers-values__table_t1w_r4q_jdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Gibt einen Iterator zurück, bei dem die Headerwerte als Zeichenfolgen dargestellt werden. |
[Tabelle : 21. Rückgaben]

{#fetch.headers-values__table_t1w_r4q_jdc}  
Das folgende Beispiel zeigt, wie Sie ein neues Header-Objekt mit mehreren Headern erstellen und festlegen Anfügen() Und gibt dann eine Liste aller Header-Werte im neuen Objekt zurück, indem Sie aufrufen Werte () Methode. Console.log() Protokolliert die Zeile in Systemprotokollen.

    // Create a test Headers object
    var myHeaders = new Headers();
    myHeaders.append("Content-Type", "text/xml");
    myHeaders.append("Vary", "Accept-Language");

    // Display the values
    for (var value of myHeaders.values()) {
      console.log(value);
    }

Ausgabe:

    text/xml
    Accept-Language


