Servie provides standard, framework-agnostic HTTP interfaces for servers and clients.

Installation

npm install servie --save

Usage

Common

Base HTTP class for common request and response logic.

import { Common } from 'servie'

Options

• headers? HTTP headers (Headers | HeadersObject | string[])
• trailers? HTTP trailers (Headers | HeadersObject | string[])
• events? An event emitter object (EventEmitter)
• body? Allowed HTTP bodies (string | Buffer | Readable | object)

Properties

• events The request/response event emitter
• headers The submitted headers as a Headers instance
• trailers The submitted trailers as a Headers instance
• body The submitted body payload
• bodyUsed A boolean indicating where the body was read
• type A shorthand property for reading and writing the Content-Type header
• length A shorthand property for reading and writing Content-Length as a number

Methods

• buffer(maxBufferSize): Promise<Buffer> Read the body into a Buffer object
• text(maxBufferSize): Promise<string> Read the body as a string
• json(maxBufferSize): Promise<object> Read the body as a JSON payload
• stream(): Readable Read the body as a Readable stream

Events

• headers Emitted when the headers object becomes available
• trailers Emitted when the trailers object becomes available

Request

HTTP class for encapsulating a Request, extends Common.

import { Request } from 'servie'

Options

Extends Common options.

• url The HTTP request url (string)
• method? The HTTP request method (string, default: GET)

Properties

• url The HTTP request url (string)
• method The HTTP request method upper-cased (string)
• Url The HTTP request url as a parsed object (object)

Methods

• destroy(): HttpError Emit an abort event
• error(message, code, status?, original?): HttpError Create a HTTP error instance

Events

• destroy Emitted when the request is destroyed/aborted

Response

HTTP class for encapsulating a Response, extends Common.

import { Response } from 'servie'

Options

Extends Common options.

• status? The HTTP response status code (number)
• statusText? The HTTP response status message (string)

Properties

• status? The HTTP response status code (number)
• statusText? The HTTP response status message (string)

Headers

Used by Common for Request and Response objects.

Options

Take a single parameter with the headers in object, array or Headers format.

Properties

• raw The raw HTTP headers list (string[])

Methods

• object(obj?: HeadersObject | null): HeadersObject | void A getter/setter method for reading the headers as a lower-cased object (like node.js)
• set(name: string, value: string | string[]): this Set a HTTP header by overriding case-insensitive headers of the same name
• append(name: string, value: string | string[]): this Append a HTTP header
• get(name: string): string | undefined Retrieve a case-insensitive HTTP header
• getAll(name: string): string[] Retrieve a list of matching case-insensitive HTTP headers
• has(name: string): boolean Check if a case-insensitive header is already set
• delete(name: string): this Delete a case-insensitive header

HTTP Error

Internally and externally triggered HTTP errors.

Properties

• code A unique error code (string)
• status A HTTP status code (number)
• request The Request instance that triggered the error (Request)
• message Standard error message (string)
• cause Specified when the HTTP error was triggered by an underlying error

JavaScript

This module is designed for ES5 environments, but also requires Promise to be available.

TypeScript

This project is written using TypeScript and publishes the definitions directly to NPM.

License

MIT