rollbar 2.26.2 → 2.26.4

package/docs/extension-exceptions.md

@@ -7,7 +7,7 @@ For most websites, the path for dealing with browser extension originating excep
 
 ## Dealing with adblockers
 
-The most common type of extension that can be problematic is adblockers.  These extensions can disable loading
+The most common type of extension that can be problematic is adblockers. These extensions can disable loading
 certain external scripts or remove elements from a page based on a simple set of heuristics.
 
 You can see a [full example](https://github.com/rollbar/rollbar.js/tree/master/examples/extension-exceptions/)
@@ -24,7 +24,7 @@ Load Rollbar.js as normal.
     captureUncaught: true,
     payload: {
       environment: 'development',
-    }
+    },
   };
 </script>
 ```
@@ -33,45 +33,50 @@ Add an html element with "bait" class names to be removed by adblockers.
 
 ```html
 <!-- bait for adblocker like addons.  If they remove this div, we should disable error reporting -->
-<div id="blocker-bait" style="height: 1px; width: 1px; position: absolute; left: -999em; top: -999em"
-     class="ads ad adsbox doubleclick ad-placement carbon-ads"></div>
+<div
+  id="blocker-bait"
+  style="height: 1px; width: 1px; position: absolute; left: -999em; top: -999em"
+  class="ads ad adsbox doubleclick ad-placement carbon-ads"
+></div>
 ```
 
 Add functions to check for the presence and visibility of our bait div.
 
 ```js
-  function disableRollbar() {
-    Rollbar.configure({enabled: false});
-  }
-
-  function checkForAds() {
-    var bait = document.getElementById("blocker-bait");
+function disableRollbar() {
+  Rollbar.configure({ enabled: false });
+}
 
-    if (bait == null) {
-      disableRollbar();
-      return;
-    }
-
-    var baitStyles = window.getComputedStyle(bait);
-    if (baitStyles && (
-        baitStyles.getPropertyValue('display') === 'none' ||
-        baitStyles.getPropertyValue('visibility') === 'hidden')) {
-      disableRollbar();
-    }
-  }
+function checkForAds() {
+  var bait = document.getElementById('blocker-bait');
 
-  function onLoadStartAdCheck() {
-    // Ad blockers generally execute just after load, let's delay ourselves to get behind it.
-    setTimeout(checkForAds, 1);
+  if (bait == null) {
+    disableRollbar();
+    return;
   }
 
-  if (window.addEventListener !== undefined) {
-    window.addEventListener('load', onLoadStartAdCheck, false);
-  } else {
-    window.attachEvent('onload', onLoadStartAdCheck);
+  var baitStyles = window.getComputedStyle(bait);
+  if (
+    baitStyles &&
+    (baitStyles.getPropertyValue('display') === 'none' ||
+      baitStyles.getPropertyValue('visibility') === 'hidden')
+  ) {
+    disableRollbar();
   }
+}
+
+function onLoadStartAdCheck() {
+  // Ad blockers generally execute just after load, let's delay ourselves to get behind it.
+  setTimeout(checkForAds, 1);
+}
+
+if (window.addEventListener !== undefined) {
+  window.addEventListener('load', onLoadStartAdCheck, false);
+} else {
+  window.attachEvent('onload', onLoadStartAdCheck);
+}
 ```
 
-The above approach is likely to work in the majority of cases, *but it is not foolproof*.  Extensions and their
+The above approach is likely to work in the majority of cases, _but it is not foolproof_. Extensions and their
 behavior evolve over time and nothing stops a user from opening their console and modifying / executing code as well.
 A practical approach involves incrementally adjusting your detection as new exceptions occur in large numbers.

package/docs/migration_v0_to_v1.md

@@ -7,19 +7,20 @@
 ### Change the config object:
 
 ```js
-var _rollbarParams = {"server.environment": "production"};
-_rollbarParams["notifier.snippet_version"] = "2"; var _rollbar=["POST_CLIENT_ITEM_ACCESS_TOKEN", _rollbarParams];
+var _rollbarParams = { 'server.environment': 'production' };
+_rollbarParams['notifier.snippet_version'] = '2';
+var _rollbar = ['POST_CLIENT_ITEM_ACCESS_TOKEN', _rollbarParams];
 ```
 
-to 
+to
 
 ```js
 var _rollbarConfig = {
-  accessToken: "POST_CLIENT_ITEM_ACCESS_TOKEN",
+  accessToken: 'POST_CLIENT_ITEM_ACCESS_TOKEN',
   captureUncaught: true,
   payload: {
-    environment: "production"
-  }
+    environment: 'production',
+  },
 };
 ```
 
@@ -29,21 +30,21 @@ e.g.
 
 ```js
 var _rollbarParams = {
-  checkIgnore: function(msg, url, lineNo, colNo, error) {
+  checkIgnore: function (msg, url, lineNo, colNo, error) {
     // don't ignore anything (default)
     return false;
   },
-  context: "home#index",
+  context: 'home#index',
   itemsPerMinute: 60,
-  level: "error",
+  level: 'error',
   person: {
     id: 12345,
-    username: "johndoe",
-    email: "johndoe@example.com"
+    username: 'johndoe',
+    email: 'johndoe@example.com',
   },
-  "server.branch": "develop",
-  "server.environment": "staging",
-  "server.host": "web1"
+  'server.branch': 'develop',
+  'server.environment': 'staging',
+  'server.host': 'web1',
 };
 ```
 
@@ -51,28 +52,28 @@ should be changed to
 
 ```js
 var _rollbarConfig = {
-  accessToken: "POST_CLIENT_ITEM_ACCESS_TOKEN",
+  accessToken: 'POST_CLIENT_ITEM_ACCESS_TOKEN',
   captureUncaught: true,
-  checkIgnore: function(msg, url, lineNo, colNo, error) {
+  checkIgnore: function (msg, url, lineNo, colNo, error) {
     // don't ignore anything (default)
     return false;
   },
   itemsPerMinute: 60,
-  logLevel: "error",
+  logLevel: 'error',
   payload: {
-    environment: "production",
-    context: "home#index",
+    environment: 'production',
+    context: 'home#index',
     person: {
       id: 12345,
-      username: "johndoe",
-      email: "johndoe@example.com"
+      username: 'johndoe',
+      email: 'johndoe@example.com',
     },
     server: {
-      branch: "develop",
-      environment: "staging",
-      host: "web1"
-    }
-  }
+      branch: 'develop',
+      environment: 'staging',
+      host: 'web1',
+    },
+  },
 };
 ```
 
@@ -80,7 +81,6 @@ var _rollbarConfig = {
 
 For the latest snippet, see the instructions here: [https://rollbar.com/docs/notifier/rollbar.js/](https://rollbar.com/docs/notifier/rollbar.js/).
 
-
 ## Update references to `_rollbar.push()`
 
 The v1 notifier has a more intuitive interface for recording errors and generic logging.
@@ -118,19 +118,18 @@ try {
 }
 ```
 
-
 ### Recording a log message
 
 From
 
 ```js
-_rollbar.push("Some log message");
+_rollbar.push('Some log message');
 ```
 
 to
 
 ```js
-Rollbar.info("Some log message");
+Rollbar.info('Some log message');
 ```
 
 #### Including custom data
@@ -138,13 +137,17 @@ Rollbar.info("Some log message");
 From
 
 ```js
-_rollbar.push({level: "warning", msg: "Some warning message", point: {x: 5, y: 10}});
+_rollbar.push({
+  level: 'warning',
+  msg: 'Some warning message',
+  point: { x: 5, y: 10 },
+});
 ```
 
 to
 
 ```js
-Rollbar.warning("Some warning message", {point: {x: 5, y: 10}});
+Rollbar.warning('Some warning message', { point: { x: 5, y: 10 } });
 ```
 
 #### Using callbacks
@@ -155,11 +158,11 @@ From
 try {
   doSomething();
 } catch (e) {
-  _rollbar.push(e, function(err, uuid) {
+  _rollbar.push(e, function (err, uuid) {
     if (err !== null) {
-      console.error("Could not report an exception to Rollbar, error: " + err);
+      console.error('Could not report an exception to Rollbar, error: ' + err);
     } else {
-      console.log("Reported exception to Rollbar, uuid: " + uuid);
+      console.log('Reported exception to Rollbar, uuid: ' + uuid);
     }
   });
 }
@@ -171,11 +174,11 @@ to
 try {
   doSomething();
 } catch (e) {
-  Rollbar.log(e, function(err, uuid) {
+  Rollbar.log(e, function (err, uuid) {
     if (err !== null) {
-      console.error("Could not report an exception to Rollbar, error: " + err);
+      console.error('Could not report an exception to Rollbar, error: ' + err);
     } else {
-      console.log("Reported exception to Rollbar, uuid: " + uuid);
+      console.log('Reported exception to Rollbar, uuid: ' + uuid);
     }
   });
 }