Serviceberry
  • Guides
  • API Reference
  • Blog

›API Reference

Guides

  • Getting Started
  • Handlers
  • Plugins
  • Serializers and Deserializers
  • Service Tree
  • Auto Responses
  • How It Works

API Reference

  • Serviceberry
  • Trunk
  • Branch
  • Leaf
  • Request
  • Response
  • HttpError

HttpError

class

Extends Error

An HTTP specific error class.

new HttpError([error[, status[, headers]]])

  • error error or string [optional]

    Error object or error message.

  • status object or number [optional]

    • code number [optional]

    • text string [optional]

  • headers object [optional]

  • originalError Error

  • clearHeaders()

  • getHeader(name)

  • getHeaders()

  • getMessage()

  • getStatus()

  • getStatusCode()

  • getStatusText()

  • hasHeader(name)

  • is(status)

  • removeHeader(name)

  • setHeader(name, value)

  • setHeaders(headers)

  • setStatus(status)

  • setStatusCode(code)

  • setStatusText(text)

  • withoutHeader(name)

Properties

originalError

Error passed into constructor

Methods

clearHeaders()

Removes all headers.

getHeader(name)

Returns a string or array

Value is an array when header is duplicated.

  • name string

    Case insensitive.

getHeaders()

Returns an object

All headers. Names are lower case and values are arrays when names are duplicated.

getMessage()

Returns a string

getStatus()

Returns an object

Status code and text if known. May have code and/or text. May be an empty object.

getStatusCode()

Returns a number or undefined

getStatusText()

Returns a string or undefined

hasHeader(name)

Returns a boolean

true when the header is in the request.

  • name string

    Case insensitive.

is(status)

Returns a boolean

true when status matches.

  • status string or number

    Status code or standard status text to test against. Case insensitive.

removeHeader(name)

Causes a header not to be sent. Causes hasHeader method to return false.

  • name string

    Case insensitive.

setHeader(name, value)

  • name string

  • value string, number or array

setHeaders(headers)

Sets headers from an object. Does NOT clear headers. Does override headers.

  • headers object

setStatus(status)

When code or text is not provided, an attempt will be made to derive one from the other. For example setStatus(200) will set status code to 200 and status text to OK and setStatus("OK") will set status text to OK and status code to 200.

  • status number, string or object
    • code number

    • text string

setStatusCode(code)

  • code number

setStatusText(text)

  • text string

withoutHeader(name)

Returns a boolean

true when the header is NOT in the request.

  • name string

    Case insensitive.

← Response
  • Properties
    • originalError
  • Methods
    • clearHeaders()
    • getHeader(name)
    • getHeaders()
    • getMessage()
    • getStatus()
    • getStatusCode()
    • getStatusText()
    • hasHeader(name)
    • is(status)
    • removeHeader(name)
    • setHeader(name, value)
    • setHeaders(headers)
    • setStatus(status)
    • setStatusCode(code)
    • setStatusText(text)
    • withoutHeader(name)
Guides
Getting StartedHandlersPluginsSerializers and DeserializersSerice TreeAuto ResponsesHow it Works
API Reference
ServiceberryTrunkBranchLeafReqeustResponseHttpError
More
BlogGitHubStarContributingLicense