JSWSLogClient

Meant to be used in development version of website client side.

JSWSLogClient autoconnects on disconnect.

JSWSLogClient sends the NETWORK_CONNECTION signal. It means [...]

Connection to server is considered established when server has confirmed the JSWSLogClient's role as sender by its protocol.

Features:

• Stack trace. Includes the full stack trace of a function call with log message in accordance with WSLogRelayd protocol.

Design choice

If calls to JSWSLogClient.log() are done before connection to server is up, a queue can be used, but it adds complexity over the simpler solution of just refusing to send anything unless server has confirmed. The use case of printing logs at early load of page for example (before JSWSLogClient has had opportunity to connect over network) isn't great.

An internal queue would be intuitive, but is often surprisingly non-trivial to implement securely.

Usage:

Import and instantiate the class.

Suggestion: Bind to global function:

var logger = new JSWSLogClient(
  "wss://address",
  "your-token",
  "JSWSLogClient",
);
window.l = logger.log.bind(logger);

Then just use as l("My log message")