Registry / testing / cypress-flaky-test-audit

cypress-flaky-test-audit

library1.0.0jsnpmunverified

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).

testing

npm install cypress-flaky-test-audit

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · CYPRESS-FLAKY-TEST

cypress-flaky-test-audit

testingjavascriptv1.0.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

flakyTestAudit

✓ import { flakyTestAudit } from 'cypress-flaky-test-audit';

✗ const flakyTestAudit = require('cypress-flaky-test-audit');

CommonJS require might not work if the package is ESM-only; verify package entry.

setupFlakyTestAudit

✓ import { setupFlakyTestAudit } from 'cypress-flaky-test-audit';

✗ import setupFlakyTestAudit from 'cypress-flaky-test-audit';

This is a named export, not default export.

CypressFlakyTestAuditOptions

✓ import { CypressFlakyTestAuditOptions } from 'cypress-flaky-test-audit';

✗ import { Options } from 'cypress-flaky-test-audit';

Exact type name required for TypeScript users.

Shows minimal setup: import and call flakyTestAudit in support/e2e.js, and register setupFlakyTestAudit in config's setupNodeEvents.

// cypress/support/e2e.js import { flakyTestAudit } from 'cypress-flaky-test-audit'; flakyTestAudit(); // cypress.config.js const { defineConfig } = require('cypress'); const { setupFlakyTestAudit } = require('cypress-flaky-test-audit'); module.exports = defineConfig({ e2e: { setupNodeEvents(on, config) { setupFlakyTestAudit(on, config); }, }, });

Debug

Known issues

breakingRequires Cypress 13+ - plugin uses modern event hooks that are not available in earlier versions.

fix

Upgrade Cypress to 13.x or higher.

affects: >=1.0.0

gotchaHTML report requires internet connection on first open to load vis-network CDN assets.

fix

Ensure network access or pre-download vis-network bundle and host locally.

affects: >=1.0.0

gotchaPlugin may impact test performance due to heavy command tracking; consider disabling in production CI if not needed.

fix

Toggle plugin via environment variable or conditional import.

affects: >=1.0.0

deprecatedThe 'audit' option will be renamed to 'output' in a future major version.

fix

Use 'output' when upgrading to v2.

affects: >=1.0.0 <2.0.0

Errors

Common errors & fixes

TypeError: flakyTestAudit is not a function

Incorrect import (default vs named) or require() used with ESM-only package.

fix

Use named import: import { flakyTestAudit } from 'cypress-flaky-test-audit';

Error: Cannot find module 'cypress-flaky-test-audit'

Package not installed or typos in import path.

fix

Run: npm install --save-dev cypress-flaky-test-audit

CypressError: `cy.visit()` failed because the browser returned an error

Plugin conflicts with other Cypress plugins or interferes with page load events.

fix

Ensure plugin initialization occurs after other plugins or use .skip() for unaffected tests.

Upgrade

Version history

1.0.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

Resources

githubhttps://github.com/sclavijosuero/cypress-flaky-test-audit ↗

packagecypress-flaky-test-audit ↗

homepagehttps://github.com/sclavijosuero/cypress-flaky-test-audit#readme ↗