Provides different connection types with a unified interface


2100.4.03 years ago5 years agoMinified + gzip package size for @dcos/connections in KB


Connections Build Status

šŸ‘©ā€šŸ”¬ Please be aware that this package is still experimental ā€” changes to the interface and underlying implementation are likely, and future development or maintenance is not guaranteed.

This package provides different connection types with a unified interface.


The following example will create an XHRConnection, add a complete event listener and open the connection. The complete listener will get called once the JSON file is loaded and the connection is closed.

import { XHRConnection, ConnectionEvent } from "@dcos/connections";

const connection = new XHRConnection("http://example.com/file.json");
connection.addListener(ConnectionEvent.COMPLETE, (event) => console.log(event));

Abstract Connection

The AbstractConnection provides the default properties, methods, states, and event-definitions to implement a custom connection.

Connection Event

The ConnectionEvent provides a common interface for all different event types.


Use the following event types...

  • OPEN when opening the connection
  • DATA every time data is received from the server
  • ERROR when an error occurred
  • COMPLETE when the connection closes without any errors
  • ABORT when the connection was aborted by something


The event target always points to the connection.

XHR Connection

The XHRConnection wraps the native XMLHttpRequest to provide a unified and easy to use interface.


The following example will create an XHRConnection to post "data" to an API server.

const connection = new XHRConnection("http://example.com/api", {
  method: "POST",
  body: "data"



This defines the resource location that you want to connect to.

Options (Optional)

An optional object containing custom settings that you want to apply to the connection.

  • headers: Any headers you want to add to your request
  • method: The request method (default: "GET")
  • body: Any data you want send with your request
  • responseType: The response type you expect (default: "json") If the server returns data that is not compatible the value of response will be null.
Response Types
Value Data type of response property
"arraybuffer" ArrayBuffer
"blob" Blob
"document" Document
"json" JavaScript object, parsed from a JSON string returned by the server
"text" DOMString

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.