Rollie is a super-simple, small (some might even call it cute) Dust helper to aid with Rollbar integration. Rollie provides a simple way to include the client Rollbar snippet in your application.
Named after an amazing baseball player with an amazing mustache.
$ npm install rollieSimply import or require the Rollie module, and let Rollie work its magic! Rollie will register itself as a helper under dust.helpers.
import 'rollie';
// the rest of your awesome application goes hereOnce rollie is imported into your application, there are two ways to use it from within your Dust template:
<head>
{@rollbar /}
</head>With the first option, Rollie will look for a variable rollbarConfig within the current Dust context and attempt to parse it.
<head>
{@rollbar configPath="config/rollbar.json" /}
</head>With the second option, Rollie will use the application's entry point by referencing require.main.filename and then attempt to resolve and parse the .json config file provided in the configPath parameter. This path should be relative to the root of your project.
To allow for more dynamic setting of configuration properties, Rollie will automatically overwrite properties provided as params to the Dust helper that exist in the Rollbar configuration object. For example, take the following config. object / corresponding Dust template:
// config/rollbar.json
{
"accessToken": "1234567890",
"captureUncaught": true,
"environment": "development",
"payload": {
// ...
}
}<head>
{@rollbar configPath="config/rollbar.json" environment="test" /}
</head>Will result in:
var _rollbarConfig = {
accessToken: '1234567890',
captureUncaught: true,
environment: 'test',
payload: {
// ...
}
};Often times, there are values that exist in your rollbar.json that you don't want to expose to the client, the serverAccessToken, for example. Rollie allows for an optional scrub parameter to be passed to the Dust helper. This parameter can either be a single value or an Array of values that represent the keys to be removed from the Rollbar configuration object before it is rendered to your Dust template. Take the example below:
// config/rollbar.json
{
"SUPER_SECRET_INFO": "xxxxxxxx",
"environment": "production",
"captureUncaught": true
}<head>
{@rollbar configPath="config/rollbar.json" scrub="SUPER_SECRET_INFO" /};
</head>Will result in:
var _rollbarConfig = {
environment: 'production',
captureUncaught: true
};Note: Rollie doesn't make any attempt to validate your Rollbar configuration object! So take a look at their docs and follow the instructions!
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent