portal-client

Portal client for Node.js

Usage no npm install needed!

<script type="module">
  import portalClient from 'https://cdn.skypack.dev/portal-client';
</script>

README

Portal

The Portal is a concise, lightweight and feature-rich JavaScript library for real-time web application development. The Portal provides socket for browser-based and Node.js-based applications that need two-way communication with servers, but also aims to utilize a full duplex connection for modern web application development.

The Portal greatly simplifies things essential to real-time web applications like connection sharing, reply, heartbeat and disconnection detection. The Portal is designed by carefully considering known issues and best practices of real-time web to provide a reliable socket based on its simple protocol.

Test suite

Since this project follows Test Driven Development (TDD) principles well, looking at and running the test suite is a best way to understand the portal deeply. Every test has a title specifying a single behavior and is wrriten in QUnit.

  • client.js: Tests portal and socket using dummy and mock transport.
  • server.js: Tests transports by interacting with portal server.

Running

In order to run test suite, you need to have Node.js.

Clone this repository or simply download it as a zip and extract it.

git clone https://github.com/flowersinthesand/portal.git
cd portal

Install dependencies. If you are on Windows, you may have trouble in installing Contextify. See a installation guide from jsdom.

npm install

Start a server on localhost at port 8080.

node test/server

To test portal.js as a browser client, open http://localhost:8080 in a browser and to test it as a Node.js client, type node test/index in other console and see the result.

Writing server

A server passing the test suite is a very portal server. Writing portal server is not such hard. One of the goals of this project from day 1 (jquery-stream) is easy to implement in server-side as simple as dealing with Ajax. As various transports and features are added, it gets harder than dealing with Ajax, but still quite easy comparing to other similar projects. The portal server in test folder is less than 2KB minified and gzipped though it doesn't matter.

Anyway, the portal server for running test suite is a good example and tutorial to write portal server. check out server.js.