Issue #76 add cleaning testData before running each test file.

docs/api/reference/globals.md

@@ -57,6 +57,7 @@ These extensions are all available on a global associative array called `_brs_`:
 {
     getStackTrace: function,
     global: associative array,
+    testData: associative array,
     mockComponent: function,
     mockComponentPartial: function,
     mockFunction: function,

docs/api/reference/test-utilities.md

@@ -57,6 +57,26 @@ print _brs_.global
 
 ------------
 
+## \_brs_.testData
+
+A reference to the temporary associative array, so that you can access it from everywhere inside your brs code. Mostly used for saving/accessing some test-specific data. Clears before running each test file.
+
+### Usage
+```brightscript
+_brs_.testData._isFooAvailable = false
+_brs_.mockFunction("isFooAvailable", sub()
+    return _brs_.testData._isFooAvailable
+end sub)
+
+isFooAvailable() ' => false
+
+_brs_.testData._isFooAvailable = true ' something happened and now it is available
+isFooAvailable() ' => true
+```
+<br/>
+
+------------
+
 # \_brs_.process
 
 Allows you to access the command line arguments and locale.

test/e2e/before-after/before-after.test.js

@@ -72,8 +72,8 @@ describe("before-after", () => {
 
         expect(results.stats).toMatchObject({
             suites: 4,
-            tests: 12,
-            passes: 9,
+            tests: 14,
+            passes: 11,
             pending: 3,
             failures: 0,
         });
@@ -85,9 +85,11 @@ describe("before-after", () => {
             { fullTitle: "nested root case 1" },
             { fullTitle: "nested root case 2" },
             { fullTitle: "nested root case 3" },
+            { fullTitle: "nested root check _brs_.testData" },
             { fullTitle: "single-level root case 1" },
             { fullTitle: "single-level root case 2" },
             { fullTitle: "single-level root case 3" },
+            { fullTitle: "single-level root check _brs_.testData" },
         ]);
     });
 });

test/e2e/before-after/mixed/tests/01-nested.test.brs

@@ -31,6 +31,16 @@ function main(args as object) as object
             m.assert.equal(m.counterB, 11, "counterB must be incremented for each test case")
         end sub)
 
+        m.it("check _brs_.testData", sub()
+            m.assert.isTrue(_brs_.testData <> invalid, "_brs_.testData should be presented")
+            m.assert.isTrue(_brs_.testData.count() = 0, "by default _brs_.testData should be equal to {}")
+
+            ' change value to check whether it clears between different test files
+            _brs_.testData = {
+                ctx: "file 1"
+            }
+        end sub)
+
         m.describe("suite 1", sub()
             m.addContext({
                 counterC: 0

test/e2e/before-after/mixed/tests/02-single-level.test.brs

@@ -37,5 +37,15 @@ function main(args as object) as object
             m.assert.isInvalid(m.counterB, "afterEach state must not spread to sibling suites")
             m.assert.equal(m.counterA, 5, "counterA must be incremented for each test case")
         end sub)
+
+        m.it("check _brs_.testData", sub()
+            m.assert.isTrue(_brs_.testData <> invalid, "_brs_.testData should be presented")
+            m.assert.isTrue(_brs_.testData.count() = 0, "by default _brs_.testData should be equal to {}")
+
+            ' change value to check whether it clears between different test files
+            _brs_.testData = {
+                ctx: "file 1"
+            }
+        end sub)
     end sub)
 end function