{"id":44665,"library":"cypress-flaky-test-audit","title":"Cypress Flaky Test Audit Plugin","description":"A Cypress plugin that provides detailed per-command analytics for test runs, including execution order, timing, retries, and pass/fail outcomes. Version 1.0.0 supports Cypress ^15.7.0 and Node.js 16.17+. It tracks command queue order, generates interactive HTML reports with vis-network graphs, and highlights slow tests via customizable thresholds. Compared to alternative flaky test tools, this plugin offers dual graph views (execution path vs. queue path), retry-aware timelines, and multiple output channels (browser console, terminal, HTML).","status":"active","version":"1.0.0","language":"javascript","source_language":"en","source_url":"https://github.com/sclavijosuero/cypress-flaky-test-audit","tags":["javascript","plugin","cypress","audit","commnads","flaky","flakyness","analysis"],"install":[{"cmd":"npm install cypress-flaky-test-audit","lang":"bash","label":"npm"},{"cmd":"yarn add cypress-flaky-test-audit","lang":"bash","label":"yarn"},{"cmd":"pnpm add cypress-flaky-test-audit","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"CommonJS require might not work if the package is ESM-only; verify package entry.","wrong":"const flakyTestAudit = require('cypress-flaky-test-audit');","symbol":"flakyTestAudit","correct":"import { flakyTestAudit } from 'cypress-flaky-test-audit';"},{"note":"This is a named export, not default export.","wrong":"import setupFlakyTestAudit from 'cypress-flaky-test-audit';","symbol":"setupFlakyTestAudit","correct":"import { setupFlakyTestAudit } from 'cypress-flaky-test-audit';"},{"note":"Exact type name required for TypeScript users.","wrong":"import { Options } from 'cypress-flaky-test-audit';","symbol":"CypressFlakyTestAuditOptions","correct":"import { CypressFlakyTestAuditOptions } from 'cypress-flaky-test-audit';"}],"quickstart":{"code":"// cypress/support/e2e.js\nimport { flakyTestAudit } from 'cypress-flaky-test-audit';\nflakyTestAudit();\n\n// cypress.config.js\nconst { defineConfig } = require('cypress');\nconst { setupFlakyTestAudit } = require('cypress-flaky-test-audit');\n\nmodule.exports = defineConfig({\n  e2e: {\n    setupNodeEvents(on, config) {\n      setupFlakyTestAudit(on, config);\n    },\n  },\n});","lang":"javascript","description":"Shows minimal setup: import and call flakyTestAudit in support/e2e.js, and register setupFlakyTestAudit in config's setupNodeEvents."},"warnings":[{"fix":"Upgrade Cypress to 13.x or higher.","message":"Requires Cypress 13+ - plugin uses modern event hooks that are not available in earlier versions.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Ensure network access or pre-download vis-network bundle and host locally.","message":"HTML report requires internet connection on first open to load vis-network CDN assets.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Toggle plugin via environment variable or conditional import.","message":"Plugin may impact test performance due to heavy command tracking; consider disabling in production CI if not needed.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use 'output' when upgrading to v2.","message":"The 'audit' option will be renamed to 'output' in a future major version.","severity":"deprecated","affected_versions":">=1.0.0 <2.0.0"}],"env_vars":null,"search_vec":"'1.0.0':28 '15.7.0':31 '16.17':34 'altern':58 'analysi':92 'analyt':15 'audit':4,88 'awar':75 'browser':81 'channel':80 'command':14,37 'commnad':89 'compar':56 'consol':82 'customiz':54 'cypress':1,7,30,87 'detail':11 'dual':65 'execut':20,68 'flaki':2,59,90 'flaky':91 'generat':40 'graph':48,66 'highlight':50 'html':42,84 'includ':19 'interact':41 'javascript':85 'multipl':78 'network':47 'node.js':33 'offer':64 'order':21,39 'outcom':26 'output':79 'pass/fail':25 'path':69,72 'per':13 'per-command':12 'plugin':5,8,63,86 'provid':10 'queue':38,71 'report':43 'retri':23,74 'retry-awar':73 'run':18 'slow':51 'support':29 'termin':83 'test':3,17,52,60 'threshold':55 'time':22 'timelin':76 'tool':61 'track':36 'version':27 'via':53 'view':67 'vis':46 'vis-network':45 'vs':70","created_at":"2026-06-07T12:51:14.755854+00:00","updated_at":"2026-06-07T12:51:14.755854+00:00","problems":[{"fix":"Use named import: import { flakyTestAudit } from 'cypress-flaky-test-audit';","cause":"Incorrect import (default vs named) or require() used with ESM-only package.","error":"TypeError: flakyTestAudit is not a function"},{"fix":"Run: npm install --save-dev cypress-flaky-test-audit","cause":"Package not installed or typos in import path.","error":"Error: Cannot find module 'cypress-flaky-test-audit'"},{"fix":"Ensure plugin initialization occurs after other plugins or use .skip() for unaffected tests.","cause":"Plugin conflicts with other Cypress plugins or interferes with page load events.","error":"CypressError: `cy.visit()` failed because the browser returned an error"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/sclavijosuero/cypress-flaky-test-audit#readme","github":"https://github.com/sclavijosuero/cypress-flaky-test-audit","docs":null,"changelog":null,"pypi":null,"npm":"cypress-flaky-test-audit","openapi_spec":null,"status_page":null,"smithery":null,"categories":["testing"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}