mochajs#5084 global variable

Author: CheadleCheadle

bin/mocha.js

@@ -84,3 +84,24 @@ Context.prototype.retries = function (n) {
   this.runnable().retries(n);
   return this;
 };
+
+/**
+ * Defines a global read-only property `mochaVar` that provides access to Mocha's name and version.
+ * It is accessible globally within the Node.js environment or in the browser
+ * @example
+ * console.log(globalThis.mochaVar); // Outputs: { name: "mocha", version: "X.Y.Z" }
+ *
+ * @property {Object} mochaVar - The global property containing Mocha's name and version.
+ * @property {string} mochaVar.name - The name of the Mocha package.
+ * @property {string} mochaVar.version - The current version of the Mocha package.
+ */
+var mochaPackageJson = require('../package.json');
+var version = mochaPackageJson.version;
+var name = mochaPackageJson.name;
+
+Object.defineProperty(globalThis, 'mochaVar', {
+  get: () => ({
+    name,
+    version
+  })
+});

lib/context.js

@@ -0,0 +1,11 @@
+'use strict';
+var mochaPackageJson = require('../../package.json');
+var version = mochaPackageJson.version;
+var name = mochaPackageJson.name;
+
+describe('Global "mocha" object', function () {
+  it('should have the properties name and version', function () {
+    expect(globalThis.mochaVar.name, 'to equal', name);
+    expect(globalThis.mochaVar.version, 'to equal', version);
+  });
+});