Headers.has()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

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

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

構文

js
has(name)

引数

name

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

返値

論理値です。

例

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

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

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

js
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

関連情報