Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
websockets with the node stream API
JavaScript
branch: master

readme.md

websocket-stream

NPM

Use HTML5 websockets using the Node Streams API.

Usage

This module works in Node or in Browsers that support WebSockets. You can use browserify to package this module for browser use.

var websocket = require('websocket-stream')
var ws = websocket('ws://realtimecats.com')
ws.pipe(somewhereAwesome)

In the example above ws is a duplex stream. That means you can pipe output to anything that accepts streams. You can also pipe data into streams (such as a webcam feed or audio data).

The underlying WebSocket instance is available as ws.socket.

On the server

Using the ws module you can make a websocket server and use this module to get websocket streams on the server:

var websocket = require('websocket-stream')
var wss = websocket.createServer({server: someHTTPServer}, handle)

function handle(stream) {
  fs.createReadStream('bigdata.json').pipe(stream)
})

Run the tests

Server-side tests

npm test

Client-side tests

First start the echo server by running node test-server.js

Then run npm start and open localhost:9966 in your browser and open the Dev Tools console to see test output.

license

BSD LICENSE

Something went wrong with that request. Please try again.