Deprecate access to non-public Spec properties in spec filters

src/core/Env.js

@@ -371,7 +371,8 @@ getJasmineRequireObj().Env = function(j$) {
       runQueue,
       TreeProcessor: j$.TreeProcessor,
       globalErrors,
-      getConfig: () => config
+      getConfig: () => config,
+      deprecated: this.deprecated
     });
 
     this.setParallelLoadingState = function(state) {

src/core/Runner.js

@@ -10,6 +10,7 @@ getJasmineRequireObj().Runner = function(j$) {
     #globalErrors;
     #reportDispatcher;
     #getConfig;
+    #deprecated;
     #executedBefore;
     #currentRunableTracker;
 
@@ -23,6 +24,7 @@ getJasmineRequireObj().Runner = function(j$) {
       this.#globalErrors = options.globalErrors;
       this.#reportDispatcher = options.reportDispatcher;
       this.#getConfig = options.getConfig;
+      this.#deprecated = options.deprecated;
       this.#executedBefore = false;
       this.#currentRunableTracker = new j$.CurrentRunableTracker();
     }
@@ -75,8 +77,9 @@ getJasmineRequireObj().Runner = function(j$) {
         orderChildren: function(node) {
           return order.sort(node.children);
         },
-        excludeNode: function(spec) {
-          return !config.specFilter(spec);
+        excludeNode: spec => {
+          const proxy = j$.deprecatingSpecProxy(spec, this.#deprecated);
+          return !config.specFilter(proxy);
         }
       });
       this.#executionTree = treeProcessor.processTree();

src/core/deprecatingSpecProxy.js

@@ -0,0 +1,36 @@
+// TODO: Remove this in the next major release.
+getJasmineRequireObj().deprecatingSpecProxy = function(j$) {
+  const allowedMembers = ['id', 'description', 'getFullName', 'getPath'];
+
+  function isMember(target, prop) {
+    return (
+      Object.keys(target).indexOf(prop) !== -1 ||
+      Object.keys(j$.Spec.prototype).indexOf(prop) !== -1
+    );
+  }
+
+  function msg(member) {
+    const memberName = member.toString().replace(/^Symbol\((.+)\)$/, '$1');
+    return (
+      'Access to private Spec members (in this case `' +
+      memberName +
+      '`) via spec filters is not supported and will break in ' +
+      'a future release. See <https://jasmine.github.io/api/edge/Spec.html> ' +
+      'for correct usage.'
+    );
+  }
+
+  function deprecatingSpecProxy(spec, deprecated) {
+    return new Proxy(spec, {
+      get(target, prop, receiver) {
+        if (isMember(target, prop) && !allowedMembers.includes(prop)) {
+          deprecated(msg(prop));
+        }
+
+        return target[prop];
+      }
+    });
+  }
+
+  return deprecatingSpecProxy;
+};

src/core/requireCore.js

@@ -42,6 +42,7 @@ var getJasmineRequireObj = (function(jasmineGlobal) {
     j$.getClearStack = jRequire.clearStack(j$);
     j$.Clock = jRequire.Clock();
     j$.DelayedFunctionScheduler = jRequire.DelayedFunctionScheduler(j$);
+    j$.deprecatingSpecProxy = jRequire.deprecatingSpecProxy(j$);
     j$.Deprecator = jRequire.Deprecator(j$);
     j$.Configuration = jRequire.Configuration(j$);
     j$.Env = jRequire.Env(j$);