Headers.get()

Headers インターフェイスの get() メソッドは、指定された名前の Headers オブジェクト内のヘッダーのすべての値の ByteString を返します。要求されたヘッダーが Headers オブジェクトに存在しない場合、null を返します。

セキュリティ上の理由から、一部のヘッダーはユーザーエージェントによってのみ制御できます。これらのヘッダーには、禁止ヘッダー名 および 禁止レスンポンスヘッダー名 が含まれます。

構文

myHeaders.get(name);

引数

name
Headers オブジェクトから値を取得する HTTP ヘッダーの名前。指定された名前が HTTP ヘッダーの名前でない場合、このメソッドは TypeError を返します。名前は大文字と小文字を区別しません。

戻り値

取得したヘッダーの値を表す ByteString シーケンス。このヘッダーが設定されていない場合は null を返します。

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

var myHeaders = new Headers(); // 現在空です
myHeaders.get('Not-Set'); // null を返します

Headers.append を使用してヘッダーを追加し、get() を使用してヘッダーを取得できます。

myHeaders.append('Content-Type', 'image/jpeg');
myHeaders.get('Content-Type'); // "image/jpeg" を返します

ヘッダーに複数の値が関連付けられている場合、ByteString には、Headers オブジェクトに追加された順序ですべての値が含まれます。

myHeaders.append('Accept-Encoding', 'deflate');
myHeaders.append('Accept-Encoding', 'gzip');
myHeaders.get('Accept-Encoding'); // "deflate,gzip" を返します

: Headers.getAll (en-US) にはこの機能があり、Headers.getHeaders オブジェクトに追加された最初の値のみを返します。最新の仕様では getAll() が削除され、すべての値を返すように get() が更新されました。

仕様書

仕様書 Status Comment
Fetch
get() の定義
現行の標準

ブラウザーの互換性

BCD tables only load in the browser

関連情報