Skip to content

gitname/real-time-react

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

real-time-react

Real-Time React: An Introduction to Socket.io

Introduction

This repository contains several proof-of-concept apps used to demonstrate strategies people have used to achieve real-time, web-based client-server communication. The strategies include HTTP polling, HTTP long polling, and WebSockets.

How's this related to socket.io? socket.io chooses between WebSockets, HTTP long polling, and other strategies, depending upon which strategies are supported by the environment in which socket.io is running.

Running each app

HTTP Polling Chat

# Download app code and install dependencies.
$ git clone https://github.com/gitname/real-time-react.git
$ cd real-time-react/http-polling-chat/
$ npm install

# Run the app.
# If using Linux shell:
$ PORT=3000 && npm start
# If using Windows terminal:
> set PORT=3000&& npm start

A note regarding the Windows terminal command: The absence of whitespace between the environment variable definition and the pair of ampersands is required, since the environment variable gets set to everything between the equals sign and the ampersand.

Then, in a web browser, visit the app at http://localhost:3000/.

Terminate the app by pressing Ctrl+C.

HTTP Long Polling Chat

# Download app code and install dependencies.
$ git clone https://github.com/gitname/real-time-react.git
$ cd real-time-react/http-long-polling-chat/
$ npm install

# Run the app.
# If using Linux shell:
$ PORT=3000 && npm start
# If using Windows terminal:
> set PORT=3000&& npm start

A note regarding the Windows terminal command: The absence of whitespace between the environment variable definition and the pair of ampersands is required, since the environment variable gets set to everything between the equals sign and the ampersand.

Then, in a web browser, visit the app at http://localhost:3000/.

Terminate the app by pressing Ctrl+C.

WebSocket Barebones

Update: Thanks to @benshell, this app now includes a client.

# Download app code and install dependencies.
$ git clone https://github.com/gitname/real-time-react.git
$ cd real-time-react/ws-barebones/
$ npm install

# Run the app.
# If using Linux shell:
$ npm start
# If using Windows terminal:
> npm start

Then, in a web browser, visit the app at http://localhost:3000/.

Terminate the app by pressing Ctrl+C.

Developing each app

Using nodemon

If you plan to make frequent changes to an app's source code, I recommend you run the app using nodemon. That (i.e. nodemon) will relaunch the app when it detects that any changes have been made to the app's source code since the app was last launched.

# Run the app.
# If using Linux shell:
$ PORT=3000 && npx nodemon start
# If using Windows terminal:
> set PORT=3000&& npx nodemon start

A note regarding the Windows terminal command: The absence of whitespace between the environment variable definition and the pair of ampersands is required, since the environment variable gets set to everything between the equals sign and the ampersand.

Then, in a web browser, visit the app at http://localhost:3000/.

Terminate the app by pressing Ctrl+C.

Evaluating each app

Consider:

  • The number of HTTP requests it submits that don't "pay off"
    • Use Chrome Developer Tools > Network tab: bottom status bar (e.g. "123 requests")
  • The size of each HTTP request it submits / response it receives
    • Use Chrome Developer Tools > Network tab: bottom status bar (e.g. "456 KB transferred")
  • How many times it establishes a TCP connection (considering the overhead involved in doing so)
  • The latency (i.e. stimulus-response delay); e.g. the delay between a message being created and that message being displayed
  • The complexity of the implementation

Miscellaneous Notes

Using Chrome

Developer Tools

Pending requests

On the Network tab, notice the Status of requests. Requests for which a response hasn't arrived yet have a status of pending. More details are available at chrome://net-internals/#events.

WebSocket frames

On the Network tab, click on an HTTP request that was used to change to the WebSocket protocol, then select the Frames tab. That tab lists all the WebSocket frames that have been sent or received via that WebSocket connection.

Using Wireshark

Filtering displayed traffic

Examples

  • Display only traffic that is both HTTP and either to or from 123.123.123.123

    http and ip.addr == 123.123.123.123
    

More examples are available on the Wireshark wiki.

WinPcap driver

Starting the WinPcap driver service

When running Wireshark as a non-Administrator in Windows, you may have to manually start the WinPcap driver service in order for any network interfaces to appear in Wireshark.

To start it, open a command prompt as an administrative user (i.e. right-click the cmd.exe icon and select "Run as Administrator") and issue the following command:

C:\> net start npf

The NetGroup Packet Filter Driver service was started successfully.

Stopping the WinPcap driver service

Exiting Wireshark does not automatically stop the driver service.

To stop it, open a command prompt as an administrative user and issue the following command:

C:\> net stop npf

The NetGroup Packet Filter Driver service was stopped successfully.

Reference: https://wiki.wireshark.org/CaptureSetup/CapturePrivileges

RFCs

Packages/Repositories

Notes from presentation/event