Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 1,000,000+ packages pre-installed, including @sugoi/socket with all npm packages installed. Try it out:

var socket = require("@sugoi/socket")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

@sugoi/socket v4.1.1

sugoi framework socket handler, based on


Sugoi logo

npm version Build Status codecov


SugoiJS is a minimal modular framework.

SugoiJS gives you the ability to use only what you need and do it fast.

this is a standalone module that can be functional on its own (as all of the SugoiJS modules).

The SugoiJS socket module uses the


npm install --save @sugoi/socket


Bootstrapping done by:

import {SocketHandler} from "@sugoi/socket";

// serverInstance is express\koa instance
// in case you are using @socket\server, the instance returns from the 'listen' method

Socket Options

Init socket server with:

namespace - assign different endpoint to the socket server, more info on documentation

socketOptions - the socket server configurations

SocketHandler.init(serverInstance, socketConfig: SocketIOStatic.ServerOptions, namespace: string): SocketIOStatic.Server

The socketOptions variable interface is the same as on documentation

      path: string,
      serveClient: boolean,

Listen to events

SugoiJS socket module provides you the @SocketOn(event:string, namespace:string) decorator.

This decorator registers the callback for an event.


// SocketOn(event: string, namespace: string = "/", ...middlewares:Array<ISocketMiddleware>) {
    console.log("log message data: %s from socket id: %s",data,;

You can use as many decorators as you want.

Get instance

For getting the socketIO server instance, use the getServer() method of the SocketHandler instance method.

const io:SocketIOStatic.Server = SocketHandler.getHandler().getServer();


You can find further information on Sugoi official website


RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free