You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 7-8.RSVP
Socket
Socket
Sign inDemoInstall

servie

Package Overview
Dependencies
Maintainers
1
Versions
47
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

servie

Standard HTTP interfaces for HTTP clients and servers in node.js and browsers


Version published
Weekly downloads
99K
increased by21.63%
Maintainers
1
Created
Weekly downloads
 

Readme

Source

Servie

NPM version NPM downloads Build status Test coverage Bundle size

Standard, framework-agnostic HTTP interfaces for JavaScript servers and clients.

Installation

npm install servie --save

Usage

import { Body, Request, Response, Headers, AbortController } from "servie";

Servie is a universal package, meaning node.js and browsers are supported without needing configuration. This means the primary endpoint requires some dom types in TypeScript. When in a node.js, or browser, only environment, prefer importing servie/dist/{node,browser} instead.

Body

Base HTTP class shared between Request and Response.

new Body(body, headers);
Body

Supported body types, depending on environment:

  • Node.js - string | Buffer | ArrayBuffer | Readable | null | undefined
  • Browser - string | ArrayBuffer | ReadableStream | null | undefined
Properties and Methods
  • bodyUsed Boolean whether the body is already consumed
  • text() Returns the body as a Promise<string>
  • json() Returns the body with JSON.parse as Promise<any>
  • arrayBuffer() Returns the body as a Promise<ArrayBuffer>
  • clone() Clones an unconsumed body
  • destroy() Consumes and destroys the body

Request

HTTP class for modelling a Request, extends Body.

new Request(input [, init]);
Input

A URL string or another Request instance to clone from.

Init
  • method? HTTP request method.
  • body? Any support body types.
  • signal? A signal from an AbortController.
  • headers? A map, list of tuples, or Header instance to initialize from.
  • trailer? A promise resolve to a support header initialization types (above).
Properties and Methods
  • url Requested url string
  • method Requested method string
  • signal Signal event emitter
  • headers A Headers instance
  • trailer A Promise<Headers> instance
  • clone() Clones the request into a new instance

Response

HTTP class for modelling a Response, extends Body.

new Response([body [, init]]);
Body

One of the support body types (above).

Init
  • status? The numeric HTTP response status code
  • statusText? The HTTP response status text
Properties and Methods
  • status The numeric HTTP response status code
  • statusText The HTTP response status text
  • ok Boolean indicates successful response (status between 200 and 299)
  • headers A Headers instance
  • trailer A Promise<Headers> instance
  • clone() Clones the response into a new instance

Headers

Map representation of HTTP headers.

new Headers([init]);
Init

Initialize headers from Iterable<HeaderTuple>, a HeadersObject or an existing Headers instance.

Methods
  • set(name: string, value: string | string[]): void Set a HTTP header by overriding case-insensitive headers of the same name
  • append(name: string, value: string | string[]): void 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): void Delete a case-insensitive header
  • asObject(): HeadersObject Return the lower-cased headers as a plain object
  • extend(obj: HeadersInit): this Extends the current headers with an object
  • keys() Iterable of the available header names
  • values() Iterable of header values
  • entries() Iterable of headers as [key, value]
  • clear() Clears the headers instance
  • clone() Clones the Headers instance

AbortController

Simple controller for aborting a Request instance.

new AbortController();
Properties and Methods
  • signal A Signal instance to pass to a Request
  • abort() Used to abort any listening requests through the signal

Signal

Tiny event emitter for communicating during a request.

Methods
  • aborted Boolean indicating whether the request is aborted
  • on(type, fn) Attach an event listener to an event type
  • off(type, fn) Remove an event listener from an event type
  • each(fn) Attach an event listener for all events
  • none(fn) Remove a global event listener
  • emit(type, ...args) Emit an event to all listeners
Standard Events
  • abort The request has been aborted
  • requestBytes Emitted on request progress with current bytes
  • requestEnded The request has ended
  • requestStarted The request has been started
  • responseBytes Emitted on response progress with current bytes
  • responseEnded The response has ended
  • responseStarted The response has started

Plugins can emit new types of events.

Implementation

If you're building the transports for Servie, there are some life cycle events you need to be aware of:

  1. Listen to the error event on signal for errors
  2. Listen to the abort event on signal to destroy the connection
  3. Resolve trailer promise and append to HTTP request or response
  4. There are some existing built-in type-safe events in SignalEvents you can support

JavaScript

This module is designed for ES2017 environments and published with TypeScript definitions on NPM.

License

Apache 2.0

Keywords

FAQs

Package last updated on 11 Sep 2020

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc