Vorlon.js

Vorlon.js is a tool built using all open source tech to allow remotely load, inspect, test and debug JavaScript code, running on any device with a web browser.

It is a small web server you can run from your local machine or on a server, that serves a dashboard, which is the interface to communicate with remote devices.

With the dashboard you can debug and test remote JavaScript applications, basically like you hit F12 in your browser.

Some of the default plugins are:

  • the Interactive Console that will stream messages from the client;
  • the DOM Explorer to help you inspect the DOM and modify its properties and the CSS;
  • the Modernizr that shows the supported browser features;
  • the XHR panel to help you analyze the calls sent by your device.
  • the My Device panel that displays you information coming from the client such as the user agent, the size of the screen, the pixel per points, etc.

How to get started

Install Vorlon

Install VorlonJS server from npm (you can install it globally or locally)

npm i -g vorlon

Start Vorlon server (local machine or server)

vorlon

# The Vorlon server is running{#the-vorlon-server-is-running}

The server is now running and you have the ability to listen to clients. To actually see the clients linked with Vorlon, you can go now to Vorlon dashboard by opening http://localhost:1337/dashboard

Insert script in your client app (remote device)

To link your client page with the Vorlon server, you need to add the following script into your page in the <head> section. It is advisable to load the script before all the others.

<script src="http://YOUR_LOCAL_MACHINE:1337/vorlon.js"></script>

Start debugging

Open your client app, go to the dashboard at http://YOUR_LOCAL_MACHINE:1337/dashboard and explore the features.

Proxy

To debug a site already in production for which the Vorlon script has not been inserted, it is possible to use the Vorlon proxy. It is a separate dashboard and is accessible at http://YOUR_LOCAL_MACHINE:1337/httpproxy. The proxy will inject the Vorlon client script when you give it a target link, and you can start the debug.

If you want to know more, check out the documentation page or the introductory video.