qjs-net

This package aims to provide simple, minimal and essential networking infrastructures for QuickJS. (Derived from minnet-quickjs)

Currently, it can:

Creating WebSocket and HTTP server
Creating WebSocket or HTTP client
fetch

Usage

Requirements:

clang or gcc
libwebsockets

To use qjs-net in your QuickJS project, run following commands:

cd your_project_dir
git clone https://github.com/rsenn/qjs-net
cd qjs-net
git submodule update --init
cd build
cmake ..

Alternatively use either premake or ninja:

premake5 gmake

or

ninja -C build

These alternative build methods can't invoke the compilation of libwebsockets, therefore you have to build and install it manually before you can compile qjs-net:

cd qjs-net
. build-libwebsockets.sh

TYPE=Release builddir=libwebsockets/build \
  build_libwebsockets 
  
make -C libwebsockets/build install

You may add the variable OPENSSL_PREFIX (e.g. OPENSSL_PREFIX=/opt/libressl-3.5.1) in front of that command when building against a custom SSL library build.

cd your_project_dir git clone https://github.com/rsenn/qjs-net cd qjs-net/build cmake ..


In your JS script:
```javascript
import * as net from 'net.so';

`net.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)
}

`net.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

License

rsenn/qjs-net

ErrorLooks like something went wrong!

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages