khanhas/minnet-quickjs

Minimal networking library for QuickJS

minnet-quickjs

This package aims to provide simple, minimal and essential networking infrastructures for QuickJS.
Currently, it can:

• Creating WebSocket server
• Creating WebSocket client
• fetch

Usage

Requirements:

• clang
• libwebsockets
• libcurl

To use minnet-quickjs in your QuickJS project, run following commands:

cd your_project_dir
git clone https://github.com/khanhas/minnet-quickjs
cd minnet-quickjs
make

In your JS script:

import * as minnet from "./minnet-quickjs/minnet.so"

minnet.server(options): Create a WebSocket server and listen to host:port.

options: an object with following properties:

• port: number, optional, default = 7981
• host: string, optional, default = "localhost"
• onConnect: function, optional
  Calls when a client connects to server. Returns client's MinnetWebsocket instance in parameter. Syntax:

onConnect: (client_socket) => {
    print("A client connected")
}

• onClose(why): function, optional
  Call when client disconnects from server. Returns disconnect reason in parameter. Syntax:

onClose: (why) => {
    print("Client disconnected. Reason: ", why)
}

• onMessage: function, optional
  Call when client sends a message to server. Returns client's MinnetWebsocket instance and received message in parameters. Syntax:

onMessage: (client_socket, message) => {
    print("Received: ", message)
}

• onPong: function, optional
  Call when client sends a pong. Returns client's MinnetWebsocket instance and received ArrayBuffer data in parameters. Syntax:

onPong: (client_socket, data) => {
    print("Pongged: ", data)
}

minnet.client(options): Create a WebSocket client and connect to a server.

options: an object with following properties:

• port: number, optional, default = 7981
• host: string, optional, default = "localhost"
• onConnect: function, optional
  Calls when client connects to server succesfully. Returns server's MinnetWebsocket instance in parameter. Syntax:

onConnect: (server_socket) => {
    print("Connected to server")
}

• onClose(why): function, optional
  Call when client disconnects from server. Returns disconnect reason in parameter. Syntax:

onClose: (why) => {
    print("Disconnected from server. Reason: ", why)
}

• onMessage: function, optional
  Call when server sends message to client. Returns server's MinnetWebsocket instance and received message in parameters. Syntax:

onMessage: (server_socket, message) => {
    print("Received: ", message)
}

• onPong: function, optional
  Call when server sends a pong. Returns server's MinnetWebsocket instance and received ArrayBuffer data in parameters. Syntax:

onPong: (server_socket, data) => {
    print("Pongged: ", data)
}

MinnetWebsocket instance

contains socket to a server or client. You can use these methods to communicate:

• .send(message): message can be string or ArrayBuffer
• .ping(data): data must be ArrayBuffer
• .pong(data): data must be ArrayBuffer

fetch(url): Get resources from url

url: a string to download resources from.
Returns MinnetResponse object that you can use these
Methods:

• .text(): Get body text as string
• .json(): Get body text, parse as JSON and returns parsed object.
• .arrayBuffer(): Get body as an ArrayBuffer

Properties:

• .ok: boolean, Read-only
  Whether the response was successful
• .url: string, Read-only
  URL of the response
• .status: number, Read-only
  Status code of the response
• .type: string, Read-only
  Type of the response

Check out example.mjs