cypress-plugin-grep-boxes 2.1.0 → 2.3.0

package/README.md

@@ -20,6 +20,7 @@ A companion Cypress plugin for <code>cy-grep</code> that allows user to run spec
 - [Open mode](#-open-mode)
   - [Using cypress-plugin-filter-runnables](#using-cypress-plugin-filter-runnables)
   - [Use Required Test Tags Instead Of Skipping Tests](#use-required-test-tags-instead-of-skipping-tests)
+- [hideSpecTags](#hideSpecTags)
 - [disableInitialAutoRun](#disableInitialAutoRun)
 - [Contributions](#contributions)
 
@@ -105,6 +106,54 @@ To run just those tests with the required tag `@skip` in interactive mode:
 npx cypress open --env grepTags=@skip
 ```
 
+## hideSpecTags
+
+The `cypress-plugin-grep-boxes` plugin (new in v2.0.0) displays all available `effectiveTestTags` in the Cypress Test Runner for each test.
+
+If for any reason you'd like to exclude tags from being displayed in the Cypress Test Runner, use the environment variable `hideSpecTags` set to an array of tags you do not want to be displayed in the Cypress Test Runner.
+
+### Hide specific tags
+
+Example:
+
+```json
+{
+  "env": {
+    "hideSpecTags": ["@smoke", "@sanity"]
+  }
+}
+```
+
+The example above would hide `@smoke` and `@sanity` tags, but show all other tags, in the Cypress Test Runner.
+
+### Hide all tags
+
+If you'd like to exclude all tags from being displayed in the Cypress Test Runner, use the following:
+
+```json
+{
+  "env": {
+    "hideSpecTags": ["*"]
+  }
+}
+```
+
+The example above would not display ANY tags to Cypress Test Runner.
+
+### Hide all tags EXCEPT specified
+
+If you'd like to ONLY display a specific subset of tags in the Cypress Test Runner, prefix tags you'd like to see displayed with `+`:
+
+```json
+{
+  "env": {
+    "hideSpecTags": ["*", "+@smoke", "+@sanity"]
+  }
+}
+```
+
+The example above would hide all tags EXCEPT `@smoke` and `@sanity` tags in the Cypress Test Runner.
+
 ## disableInitialAutoRun
 
 Cypress Test Runner UI automatically runs available tests once a spec file is open.

package/index.js

@@ -402,11 +402,45 @@ export const addTags = () => {
 
 function getTagsForTitle(title, fullTagsObj) {
   const test = fullTagsObj[title];
-  if (!test) {
-    return []; // Title not found
+  if (!test) return [];
+
+  const allTags = [...test.effectiveTestTags, ...test.requiredTestTags];
+
+  let raw = Cypress.env('hideSpecTags');
+  if (!raw) return allTags;
+
+  let rules = Array.isArray(raw)
+    ? raw
+    : String(raw)
+        .split(',')
+        .map((s) => s.trim());
+
+  const includeSet = new Set();
+  const excludeSet = new Set();
+  let hideAll = false;
+
+  for (const r of rules) {
+    if (r === '*') {
+      hideAll = true;
+      continue;
+    }
+    if (r.startsWith('+')) {
+      includeSet.add(r.substring(1));
+    } else {
+      excludeSet.add(r);
+    }
   }
 
-  return [...test.effectiveTestTags, ...test.requiredTestTags];
+  // Apply tag display filtering logic
+  return allTags.filter((tag) => {
+    if (includeSet.has(tag)) return true;
+
+    if (hideAll) return false;
+
+    if (excludeSet.has(tag)) return false;
+
+    return true;
+  });
 }
 
 function renderTagPills(tags, container) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cypress-plugin-grep-boxes",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "Cypress plugin that allows user to run specific tests in open mode.",
   "main": "./index.js",
   "keywords": [