Headers

Polyfill for Headers, as specified in the Fetch Spec.

See more...

Deprecated: see https://angular.io/guide/http

class Headers {
  static fromResponseHeaderString(headersString: string): Headers
  constructor(headers?: Headers | { [name: string]: any; })
  append(name: string, value: string): void
  delete(name: string): void
  forEach(fn: (values: string[], name: string, headers: any) => void): void
  get(name: string): string | null
  has(name: string): boolean
  keys(): string[]
  set(name: string, value: string | string[]): void
  values(): string[][]
  toJSON(): {...}
  getAll(name: string): string[] | null
  entries()
}

Description

The only known difference between this Headers implementation and the spec is the lack of an entries method.

Static methods

fromResponseHeaderString()
Returns a new Headers instance from the given DOMString of Response Headers
static fromResponseHeaderString(headersString: string): Headers Parameters headersString string Returns Headers

Constructor

constructor(headers?: Headers | { [name: string]: any; }) Parameters headers Headers | { [name: string]: any; } Optional. Default is undefined.

Methods

append()
Appends a header to existing list of header values for a given header name.
append(name: string, value: string): void Parameters name string value string Returns void

delete()
Deletes all header values for the given name.
delete(name: string): void Parameters name string Returns void

forEach()
forEach(fn: (values: string[], name: string, headers: any) => void): void Parameters fn (values: string[], name: string, headers: any) => void Returns void

get()
Returns first header that matches given name.
get(name: string): string | null Parameters name string Returns string | null

has()
Checks for existence of header by given name.
has(name: string): boolean Parameters name string Returns boolean

keys()
Returns the names of the headers
keys(): string[] Parameters There are no parameters. Returns string[]

set()
Sets or overrides header value for given name.
set(name: string, value: string | string[]): void Parameters name string value string | string[] Returns void

values()
Returns values of all headers.
values(): string[][] Parameters There are no parameters. Returns string[][]

toJSON()
Returns string of all headers.
toJSON(): { [name: string]: any; } Parameters There are no parameters. Returns `{ }`

getAll()
Returns list of header values for a given name.
getAll(name: string): string[] | null Parameters name string Returns string[] | null

entries()
This method is not implemented.
entries() Parameters There are no parameters.

Usage notes

Example

import {Headers} from '@angular/http';

var firstHeaders = new Headers();
firstHeaders.append('Content-Type', 'image/jpeg');
console.log(firstHeaders.get('Content-Type')) //'image/jpeg'

// Create headers from Plain Old JavaScript Object
var secondHeaders = new Headers({
  'X-My-Custom-Header': 'Angular'
});
console.log(secondHeaders.get('X-My-Custom-Header')); //'Angular'

var thirdHeaders = new Headers(secondHeaders);
console.log(thirdHeaders.get('X-My-Custom-Header')); //'Angular'