@codesight/codesight-js v1.0.1
Codesight, runtime insights at dev time.
JavaScript client for capturing events in web browsers or nodejs for CodeSight.
Installation
yarn
yarn add codesight-js
npm
npm install codesight-js
script tag
<script src="https://unpkg.com/codesight-js@1.0.0/dist/index.js"></script>
inline script
<script>
!function(n,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((n=n||self).cdst={})}(this,function(t){"use strict";function s(n,e,t){return e in n?Object.defineProperty(n,e,{value:t,enumerable:!0,configurable:!0,writable:!0}):n[e]=t,n}var i,n;(n=i||(i={}))[n.function=0]="function";var a="platform.codesight.cloud",c="/api/1/session",e=function n(e){var r=this;!function(n,e){if(!(n instanceof e))throw new TypeError("Cannot call a class as a function")}(this,n),s(this,"session",void 0),s(this,"_onEvent",function(n,e){r.session.events[n]=e}),s(this,"invoke",function(n,e){var t=encodeURIComponent(n+e),s=r.session.events[t];s?s.count++:s={name:n,file:e,count:1,type:i.function},r._onEvent(t,s)}),s(this,"startSession",function(n){return r.session={id:function(){function n(){return Math.floor(65536*(1+Math.random())).toString(16).substring(1)}return n()+n()+"-"+n()+"-"+n()+"-"+n()+"-"+n()+n()+n()}(),apiKey:n.apiKey,project:n.project,environment:n.environment,start:new Date,end:null,events:{}},r.session}),s(this,"closeSession",function(){return r.session.end=new Date,r.session}),s(this,"postSession",function(){var n=!(0<arguments.length&&void 0!==arguments[0])||arguments[0];if(0<Object.keys(r.session.events).length)if(XMLHttpRequest){var e=new XMLHttpRequest;e.open("POST","https://"+a+c,n),e.setRequestHeader("Content-type","application/json; charset=utf-8"),e.onreadystatechange=function(){4===e.readyState&&204===e.status&&(r.session.events={})},e.send(JSON.stringify(r.session))}else if(require){var t=require("https"),s=JSON.stringify(r.session),i={hostname:a,port:443,path:c,method:"POST",headers:{"Content-Type":"application/json; charset=utf-8","Content-Length":s.length}},o=t.request(i,function(n){n.on("data",function(){r.session.events={}})});o.write(s),o.end()}}),s(this,"postSessionAndExit",function(){process&&(r.closeSession(),r.postSession(),setTimeout(function(){process.exit()},5e3))}),this.session=this.startSession(e),setInterval(this.postSession.bind(this,!1),e.interval||3e4),window&&window.addEventListener("beforeunload",function(){r.closeSession(),navigator.sendBeacon?navigator.sendBeacon("https://"+a+c,JSON.stringify(r.session)):r.postSession(!1)})};t.instance={invoke:function(){},startSession:function(){},closeSession:function(){},postSession:function(){}};t.Client=e,t.initialize=function(n){return t.instance=new e(n),t.instance},t.i=function(n,e){t.instance.invoke(n,e)},Object.defineProperty(t,"__esModule",{value:!0})});
</script>
Setup
Basic Usage
First you need to initialize the client with your API key, project Id and environment Id. These can be found in your envrionment from CodeSight.cloud.
import * as cdst from 'codesight-js';
cdst.initialize({
apiKey: '',
project: '',
envrionment: '',
error: false, // optional, defaults to false
interval: 30000, // optional, defaults to 30000
});
interval
Number of milliseconds to wait between sending session data back to CodeSight. Defaults to 30 seconds.
Function calls can then be reported to CodeSight using:
// myFunction: Function Name
// aW5kZXguanM=: LZ compressed base64 encoded filename (index.js) relative to .codesight file
cdst.i('myFunction', 'aW5kZXguanM=');
The VSCode extension (highly recommended) adds a command to add an invoke
call and will automatically generate the LZ compressed base64 encoded filename.
Session data will be automatically sent back to CodeSight every 30 seconds (or the interval you configured during initialization).
Session data can be sent back manually at any point using:
// Or via exposed postSession
cdst.postSession();
When initializing the client an event handler to beforeunload
is attached (if running in a browser environment), this event handler will close the session
and send back any remaining session data.
When running in a nodejs envrionment you can call cdst.postSessionAndExit
to post back the session data, after 10 seconds process.exit
will be called.