Headers.has()

has() は Headers インターフェイスのメソッドで、 Headers オブジェクトに指定された特定のヘッダーがあるかどうかを示す論理値を返します。

セキュリティ上の理由から、いくつかのヘッダーはユーザーエージェントでしか制御できません。これには、禁止ヘッダー名と禁止レスポンスヘッダー名があります。

構文

has(name)

引数

name

テストしたい HTTP ヘッダーの名前。指定された名前が有効な HTTP ヘッダーの名前でない場合、このメソッドで TypeError 例外が発生します。

返値

論理値です。

例

空の Headers オブジェクトを作成するのは簡単です。

const myHeaders = new Headers(); // Currently empty

これに Headers.append を使用してヘッダーを追加し、has() を使用してヘッダーが存在するかどうかをテストすることができます。

myHeaders.append('Content-Type', 'image/jpeg');
myHeaders.has('Content-Type'); // Returns true
myHeaders.has('Accept-Encoding'); // Returns false

仕様書

Specification
Fetch Standard
# ref-for-dom-headers-has①

ブラウザーの互換性

BCD tables only load in the browser

関連情報