Add {clear,get}Context methods

Fixes #286

Author: mattrobenolt

CHANGELOG.md

@@ -6,6 +6,8 @@
 * NEW: Add ability to swap in a custom transport. Adds `Raven.setTransport`, and `transport` option to config. Docs: https://docs.getsentry.com/hosted/clients/javascript/config/
 * CHANGE: Always expose `Raven` to `window`. Please call `Raven.noConflict()` if you want it restored to what it was. See: https://github.com/getsentry/raven-js/pull/393
 * DEPRECATED: Replace `Raven.setReleaseContext` with `Raven.setRelease`.
+* NEW: Add `Raven.clearContext()` to empty all of the context.
+* NEW: Add `Raven.getContext()` to get a copy of the current context.
 
 ## 1.1.22
 

src/raven.js

@@ -324,6 +324,27 @@ var Raven = {
         return Raven;
     },
 
+    /*
+     * Clear all of the context.
+     *
+     * @return {Raven}
+     */
+    clearContext: function() {
+        globalContext = {};
+
+        return Raven;
+    },
+
+    /*
+     * Get a copy of the current context. This cannot be mutated.
+     *
+     * @return {object} copy of context
+     */
+    getContext: function() {
+        // lol javascript
+        return JSON.parse(JSON.stringify(globalContext));
+    },
+
     /*
      * Set release version of application
      *

test/raven.test.js

@@ -1860,6 +1860,25 @@ describe('Raven (public API)', function() {
         });
     });
 
+    describe('.clearContext', function() {
+        it('should clear the globalContext object', function() {
+            globalContext = {tags: {}, extra: {}, user: {}};
+            Raven.clearContext();
+            assert.deepEqual(globalContext, {});
+        });
+    });
+
+    describe('.getContext', function() {
+        it('should retrieve a copy of the current context', function() {
+            globalContext = {tags: {a: 1}};
+            var context = Raven.getContext();
+            assert.deepEqual(globalContext, context);
+            context.tags.a = 2;
+            // It shouldn't have mutated the original
+            assert.equal(globalContext.tags.a, 1);
+        });
+    });
+
     describe('.setRelease', function() {
         it('should set the globalOptions.release attribute', function() {
             Raven.setRelease('abc123');