Add namespace helper.

script/namespace.js

@@ -0,0 +1,17 @@
+var GOVUK = GOVUK || {};
+GOVUK.performance = {};
+
+GOVUK.performance.addToNamespace = function (name, obj) {
+  if (GOVUK.performance[name] === undefined) {
+    GOVUK.performance[name] = obj;
+  } 
+  else {
+    throw new Error("There is already a key: '" + name + "' in the namespace.");
+  }
+};
+
+
+GOVUK.performance.close = function () {
+  GOVUK.performance.addToNamespace = undefined;
+  GOVUK.performance.close = undefined;
+};

tests/unit/namespaceSpec.js

@@ -0,0 +1,22 @@
+describe("namespacing", function () {
+
+  it("should add to the namespace", function () {
+    GOVUK.performance.addToNamespace("foo", function () { return "bar"; });
+    expect(GOVUK.performance.foo()).toBe("bar");
+  });
+
+
+  it("should throw an exception if the name already exists and not add to the namespace", function () {
+    expect(function () { GOVUK.performance.addToNamespace("foo", "blah blah blah"); })
+      .toThrow(new Error("There is already a key: 'foo' in the namespace."));
+    expect(GOVUK.performance.foo()).toBe("bar");
+  });
+
+
+  it("should remove namespace helpers when closed", function () {
+    GOVUK.performance.close();
+    expect(function () { GOVUK.performance.addToNamespace("test", {}); }).toThrow("Property 'addToNamespace' of object #<Object> is not a function");
+    expect(function () { GOVUK.performance.close(); }).toThrow("Property 'close' of object #<Object> is not a function");
+  });
+
+});

tests/unit/unit_tests.html

@@ -12,10 +12,12 @@
     <script type="text/javascript" src="../lib/jasmine-1.3.1/jasmine-html.js"></script>
 
     <!-- include source files here... -->
+    <script type="text/javascript" src="../../script/namespace.js"></script>
     <script type="text/javascript" src="../../script/lightGate.js"></script>
     <script type="text/javascript" src="../../script/cookieUtils.js"></script>
 
     <!-- include spec files here... -->
+    <script type="text/javascript" src="namespaceSpec.js"></script>
     <script type="text/javascript" src="../stubAnalyticsService.js"></script>
     <script type="text/javascript" src="lightGateSpec.js"></script>
     <script type="text/javascript" src="cookieUtilsSpec.js"></script>