---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# ヘッダーのフェッチ - スコープ対象、グローバル

# ヘッダーのフェッチ - スコープ対象、グローバル {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：14分

Fetch Headers API を使用すると、要求ヘッダーまたは応答ヘッダーのリストからヘッダーを取得、設定、追加、および削除できます。  
この API は、外部 Web サイトからリソースを取得するためのさまざまなアクションを提供する一連の フェッチ API の一部です。完全な Fetch API コレクションには次のものが含まれます。

* [fetch:fetch(文字列、リソース、オブジェクトオプション)](https://servicenow-prod.fluidtopics.net/nG7Qv~KehJo7ZcKFZf_SoQ#fetch.fetch_S_O "ネットワークからリソースをフェッチするプロセスを開始し、応答が利用可能になると履行される約束を返します。"):ネットワークからリソースを取得するプロセスを開始します。
* [ヘッダーのフェッチ - スコープ対象、グローバル](https://servicenow-prod.fluidtopics.net/BRSxm2LfuG1OQfwKivCz6A#Fetch.HeadersAPI "Fetch Headers API を使用すると、要求ヘッダーまたは応答ヘッダーのリストからヘッダーを取得、設定、追加、および削除できます。"):要求ヘッダーと応答ヘッダーを取得して変更します。
* [要求のフェッチ: スコープ、グローバル](https://servicenow-prod.fluidtopics.net/q6k2zJB093RT7AfgmOesVg#Fetch.RequestAPI "フェ ッチ要求 API には、アプリケーションがサーバーから JSON、テキスト、バイナリデータなどのリソースを非同期に要求し、応答を処理できるように、要求オブジェクトを作成または取得するためのメソッドが含まれています。この API は、GET、POST、PUT、DELETE などのさまざまな HTTP メソッドをサポートしています。"):新しい要求オブジェクトを作成します。
* [RequestInit のフェッチ :スコープ対象、グローバル](https://servicenow-prod.fluidtopics.net/FbuvdJK7Y~BIFR4y24ajuw#Fetch.RequestInitAPI "RequestInit API には、フェッチ要求を構成するオプションが用意されています。"):フェッチ要求を構成するオプションを設定します。
* [応答をフェッチ: スコープ指定、グローバル](https://servicenow-prod.fluidtopics.net/lfdUPSm3I57751xwDSYN6g#Fetch.ResponseAPI "応答 のフェッチ API は、新しい応答オブジェクトを作成するためのメソッドと、フェ ッチ要求 API メソッドによって作成された応答本文を処理するためのメソッドを提供します。"):新しい応答オブジェクトを作成します。
{#Fetch.HeadersAPI__ul_akb_fsf_pdc}

フェッチアクションをサポートするために、システムプロパティ `glide.hosts.allowlist` を使用すると、フェッチメソッドがアクセスできるホストを制御できます。これは、 RestMessageV2 などの HTTP API や上記の API に適用されます。`glide.hosts.allowlist` の詳細については、「[Available system properties](https://www.servicenow.com/docs/access?context=r_AvailableSystemProperties&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」を参照してください。

## ヘッダーをフェッチ:headers(init) {#ariaid-title2}

Headers() コンストラクタは、新しい空の Headers オブジェクトを作成します。init パラメーターを使用して、HTTP ヘッダーのリストを使用して新しいヘッダーオブジェクトを作成し、事前入力することもできます。
注:  
既存のヘッダーオブジェクトにヘッダーを追加するには、 [ヘッダーをフェッチ:append(文字列名, 文字列値)](https://servicenow-prod.fluidtopics.net/BRSxm2LfuG1OQfwKivCz6A#fetch.headers-append_S_S "Headers オブジェクト内の既存のヘッダーに新しい値を追加するか、まだ存在しない場合はヘッダーを追加します。")を使用します。
{#fetch.headers-constructor__table_nzn_3rv_gdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 初期化 | オブジェクト | オプション。新しい Headers オブジェクトに事前入力する HTTP ヘッダーを含むオブジェクトリテラル。 有効な値： * 文字列値を含むオブジェクトリテラル * 名前と値のペアのアレイ * 既存の Headers オブジェクト (新しいオブジェクトが既存のオブジェクトからデータをコピーする場所)。 デフォルト:空のヘッダーオブジェクトを作成します |
[表 : 1. パラメーター]

{#fetch.headers-constructor__table_nzn_3rv_gdc}  
次の例は、 Headers() コンストラクターを使用して、ヘッダーのあるオブジェクトとヘッダーのない新しい Headers オブジェクトを作成する方法を示しています。

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

## ヘッダーをフェッチ:append(文字列名, 文字列値) {#ariaid-title3}

Headers オブジェクト内の既存のヘッダーに新しい値を追加するか、まだ存在しない場合はヘッダーを追加します。
指定されたヘッダーがすでに存在する場合、 `append() は` 既存の値を指定された値に変更します。指定されたヘッダーがすでに存在し、複数の値を受け入れる場合、 `append()` は値セットの最後に新しい値を追加します。古い値を新しい値で上書きするには、 [ヘッダーをフェッチ:set(文字列名, 文字列値)](https://servicenow-prod.fluidtopics.net/BRSxm2LfuG1OQfwKivCz6A#fetch.headers-set_S_S "Headers オブジェクト内の既存のヘッダーの値を更新するか、ヘッダーがまだ存在しない場合は、指定された値で新しいヘッダーを作成します。")を使用します。
{#fetch.headers-append_S_S__table_kpj_czp_jdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| name | 文字列 | 必須です。ヘッダーオブジェクトに追加する HTTP ヘッダーの名前。 |
| value | 文字列 | 必須です。追加する HTTP ヘッダーの値。 |
[表 : 2. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 3. 返される内容]

{#fetch.headers-append_S_S__table_lpj_czp_jdc}  
次の例は、 append() を使用してヘッダーを追加する方法を示しています。

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

出力:

    "image/jpeg"

次の例は、複数の値を受け入れる新しいヘッダーを追加する方法を示しています。

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

出力:

    {"deflate", "gzip"} 

## ヘッダーをフェッチ:delete(文字列名) {#ariaid-title4}

現在のヘッダーオブジェクトからヘッダーを削除します。
{#fetch.headers-delete_S__table_zpr_f1q_jdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| name | 文字列 | ヘッダーオブジェクトから削除する HTTP ヘッダーの名前。 |
[表 : 4. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 5. 返される内容]

{#fetch.headers-delete_S__table_aqr_f1q_jdc}  
次の例は、 最初に append() を使用して Headers オブジェクトにヘッダーを追加し、次に delete() を使用して同じヘッダーを削除する方法を示しています。

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

次の例は、Headers オブジェクトが既に削除されている場合、エンドポイントが値 null を返すことを示しています。

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

出力:

    null

## ヘッダーをフェッチ:entries() {#ariaid-title5}

Headers オブジェクトに含まれるすべてのキーと値のペア (文字列で表される) を循環できるようにする反復子を返します。
{#fetch.headers-entries__table_es2_fbq_jdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 6. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 反復子 | キーと値の両方のペアが文字列オブジェクトである反復子オブジェクトを返します。 |
[表 : 7. 返される内容]

{#fetch.headers-entries__table_fs2_fbq_jdc}  
次の例は、テスト Headers オブジェクトを作成し、 entries() メソッドを使用して Headers オブジェクト内のすべての値の反復子を返す方法を示しています。

    // 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]}`);
    }

出力:

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

## ヘッダーをフェッチ:forEach(Function callbackFn, Object thisArg) {#ariaid-title6}

ヘッダーオブジェクトのキー/値のペアごとにコールバック関数を 1 回実行します。
コールバック関数は、削除されたキーに対しては実行されませんが、値が未定義の場合でも、既存のキーに対しては実行されます。
{#fetch.headers-forEach_O_S__table_pjv_xcq_jdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| コールバックFn | 関数 | ヘッダーオブジェクトのキー/値のペアごとに実行する関数。 `callbackFn(文字列キー、文字列値)` の形式に準拠します。 |
| callbackFn.value | 文字列 | ヘッダーエントリの値。 |
| callbackFn.key | 文字列 | ヘッダーエントリの名前。 |
| callBackFn.object | ヘッダー | 反復するヘッダーオブジェクト。 |
| thisArg | オブジェクト | `コールバック`を実行するときに`これ`として使用する値。 |
[表 : 8. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 9. 返される内容]

{#fetch.headers-forEach_O_S__table_qjv_xcq_jdc}  
次の例では、Headers オブジェクトのキーと値のペアごとに行をログに記録します。

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

出力:

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

## ヘッダーをフェッチ:get(文字列名) {#ariaid-title7}

指定された Headers オブジェクトのすべてのヘッダー値の文字列を返します。ヘッダーが存在しない場合は null を返します。
{#fetch.headers-get_S__table_lg2_kfq_jdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| name | 文字列 | ヘッダー値を取得する HTTP ヘッダーの名前 (大文字と小文字の区別なし)。 |
[表 : 10. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | 取得されたヘッダーの値 (文字列として表されます)。ヘッダーが設定されていない場合は null。 ヘッダーが存在しない場合はエラーを返します。指定された名前が HTTP ヘッダーの名前でない場合は、タイプエラーを返します。 |
[表 : 11. 返される内容]

{#fetch.headers-get_S__table_mg2_kfq_jdc}  
以下は、 append() を使用して複数のヘッダーを持つヘッダーオブジェクトを作成し、 get() メソッドを使用してヘッダーの値を返す方法を示しています。

    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"

出力:

    [ "deflate", "gzip" ]

## ヘッダーをフェッチ:getSetCookie() {#ariaid-title8}

応答に関連付けられているすべての Set-Cookie ヘッダーを返します。
{#fetch.headers-getSetCookie__table_spp_hgq_jdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 12. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列のアレイ | 応答に関連付けられているすべての Set-Cookie ヘッダーの値を含む文字列のアレイ。このメソッドは、Set-Cookie ヘッダーが設定されていない場合、空の配列を返します。 |
[表 : 13. 返される内容]

{#fetch.headers-getSetCookie__table_tpp_hgq_jdc}  
次のスクリプト例は、 getSetCookie() を使用して応答に関連付けられたヘッダー値を返す方法を示しています。

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

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

    headers.getSetCookie();

出力:

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

## ヘッダーをフェッチ:has(文字列名) {#ariaid-title9}

Headers オブジェクトに指定されたヘッダーが含まれているかどうかを示すブール値を返します。
{#fetch.headers-has_S__table_bvr_r3q_jdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| name | 文字列 | ヘッダーオブジェクトに存在するかどうかを確認するための HTTP ヘッダーの名前。 |
[表 : 14. パラメーター]

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

| タイプ | 説明 |
|-|-|
| ブーリアン | 指定されたヘッダーがヘッダーオブジェクトに存在するかどうかを示すフラグ。指定されたヘッダーが有効な HTTP ヘッダー名でない場合は、TypeError が返されます。 可能な値： * true:ヘッダーはオブジェクトに存在します。 * false:オブジェクトにヘッダーが存在しません。 {#fetch.headers-has_S__ul_om2_lkq_jdc} |
[表 : 15. 返される内容]

{#fetch.headers-has_S__table_cvr_r3q_jdc}  
次の例では、 Headers() メソッドと append() メソッドを使用して、Content-Type ヘッダーを持つ Headers オブジェクトを作成および設定します。次に、この例では、 has() メソッドを使用して、Content-Type ヘッダーが Headers オブジェクトに存在するが、Accept-Coding ヘッダーが存在しないことを示します。

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

出力:

    true
    false

## ヘッダーをフェッチ:keys() {#ariaid-title10}

Headers オブジェクトに含まれるすべてのキーを循環できる反復子を返します。
[ヘッダーをフェッチ:values()](https://servicenow-prod.fluidtopics.net/BRSxm2LfuG1OQfwKivCz6A#fetch.headers-values "Headers オブジェクトに含まれるすべてのヘッダー値を循環できる反復子を返します。") メソッドを使用して、すべてのヘッダーキーを返します。
{#fetch.headers-keys__table_hql_jmq_jdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 16. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 反復子 | ヘッダーキーが文字列として表される反復子を返します。 |
[表 : 17. 返される内容]

{#fetch.headers-keys__table_iql_jmq_jdc}  
次の例は、キーを持つ Headers オブジェクトを作成し、 keys() メソッドを使用して使用可能なヘッダーのリストを返す方法を示しています。

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

出力:

    content-type
    vary

## ヘッダーをフェッチ:set(文字列名, 文字列値) {#ariaid-title11}

Headers オブジェクト内の既存のヘッダーの値を更新するか、ヘッダーがまだ存在しない場合は、指定された値で新しいヘッダーを作成します。
データを上書きせずに既存のヘッダーに新しい値を追加するには、 [ヘッダーをフェッチ:append(文字列名, 文字列値)](https://servicenow-prod.fluidtopics.net/BRSxm2LfuG1OQfwKivCz6A#fetch.headers-append_S_S "Headers オブジェクト内の既存のヘッダーに新しい値を追加するか、まだ存在しない場合はヘッダーを追加します。") メソッドを使用します。
{#fetch.headers-set_S_S__table_q1b_1nq_jdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| name | 文字列 | 新しい値を設定する HTTP ヘッダーの名前。指定された名前が HTTP ヘッダーの名前でない場合は、TypeError をスローします。 |
| value | 文字列 | 指定されたヘッダーに設定する新しい値。 |
[表 : 18. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 19. 返される内容]

{#fetch.headers-set_S_S__table_r1b_1nq_jdc}  
次の例は、 append() を使用して新しい Headers オブジェクトにヘッダーを設定し、 set() を使用して値をリセットする方法を示しています。

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

出力:

    text/html

次の例は、Headers オブジェクトが複数の値を受け入れる場合に、そのオブジェクトに値を設定する方法を示しています。

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

出力:

    gzip

## ヘッダーをフェッチ:values() {#ariaid-title12}

Headers オブジェクトに含まれるすべてのヘッダー値を循環できる反復子を返します。
すべてのヘッダー値を返すには、 [ヘッダーをフェッチ:keys()](https://servicenow-prod.fluidtopics.net/BRSxm2LfuG1OQfwKivCz6A#fetch.headers-keys "Headers オブジェクトに含まれるすべてのキーを循環できる反復子を返します。") メソッドを使用します。
{#fetch.headers-values__table_s1w_r4q_jdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 20. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | ヘッダー値が文字列として表される反復子を返します。 |
[表 : 21. 返される内容]

{#fetch.headers-values__table_t1w_r4q_jdc}  
次の例は、 append() メソッドを使用して複数のヘッダーを持つ新しい Headers オブジェクトを最初に作成して設定し、 values() メソッドを呼び出して新しいオブジェクト内のすべてのヘッダー値のリストを返す方法を示しています。Console.log() は 行をシステムログに記録します。

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

出力:

    text/xml
    Accept-Language