pgross41 / f-twelve

Render client console output to the DOM for troubleshooting environments that do not have a dev console

Home Page:https://engineering.cerner.com/f-twelve/demo/demo.html

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

F-Twelve

License js-standard-style

Render console output to the DOM and provide an input console for troubleshooting environments that do not have the usual F12 dev console. The tool is designed to be included in Production code. Features include:

  • Written in vanilla JavaScript and minified to add as little overhead as possible.
  • Automatically starts hidden and is attached to the DOM via JS or keyboard shortcut.
  • Provides callbacks for when attaching to the DOM. This could be used, for example, to use F-Twelve's "debug hotkey" to enable additional "debug mode" features in the consuming application.

Usage

Include dist/f-twelve.umd.js. and dist/f-twelve.css in your web application and it will enable F-Twelve. To view the tool, call FTwelve.show() or press and hold F+1+2 in that order. A demo page with examples of the API can be found in demo/demo.html. It is a static file and does not need to be served, just double click to view.

The Global Require steps will work anywhere but ES6 import steps are also below. Add the following to package.json to add the project to NPM dependencies, note the release version can be specified:

"f-twelve": "git+https://github.com/cerner/f-twelve#v1.0.0"

Global Require

JS: Include f-twelve.umd.js in any HTML file to enable the tool and make the FTwelve object globally available:

<script src="./node_modules/f-twelve/dist/f-twelve.umd.js"></script>

CSS:

<link rel="stylesheet" href="./node_modules/f-twelve/dist/f-twelve.css"/>

ES6 import

JS: Import the module and the FTwelve object with the API will be globally available:

import "f-twelve";

CSS: Use the link tag above to include CSS, or if you are using a style loader with your bundler:

import "f-twelve/dist/f-twelve.css";

Initialization

Once the JS script is included, no further configuration is required. It will be hidden and waiting for the F+1+2 keyboard shortcut. There is also a global FTwelve object object with an API.

See Demo Page for demo and full API.

About

Render client console output to the DOM for troubleshooting environments that do not have a dev console

https://engineering.cerner.com/f-twelve/demo/demo.html

License:Apache License 2.0


Languages

Language:JavaScript 90.7%Language:CSS 8.5%Language:Dockerfile 0.8%