{"id":18867,"library":"tronscan-test","title":"TronScan Test","description":"TronScan Test v1.4.2 is an AI-driven E2E and API test automation toolkit specifically built for tronscan.org. It leverages Playwright and agentic patterns (Planner/Generator/Healer/DataValidator) to provide 47 pre-built test cases across 6 pages (Homepage, Block, Transaction, Address, Contract, Token List). Unlike generic test frameworks, it offers a unified CLI (init, test, report, setup-agent, mcp, heal), built-in AI agent configuration for Claude, Cursor, Copilot, and Windsurf, and an MCP server for AI tool integration. It supports headed/headless mode, HTML reports with video, trace, and screenshot. Requires @playwright/test >=1.56.0.","status":"active","version":"1.4.2","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","tronscan","tron","blockchain","e2e","testing","playwright","agentic-testing","mcp"],"install":[{"cmd":"npm install tronscan-test","lang":"bash","label":"npm"},{"cmd":"yarn add tronscan-test","lang":"bash","label":"yarn"},{"cmd":"pnpm add tronscan-test","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"E2E testing framework; peer dependency with version constraint >=1.56.0","package":"@playwright/test","optional":false}],"imports":[{"note":"CLI is invoked via npx; not a library import. For programmatic use, see GitHub.","wrong":"npm run tronscan-test","symbol":"default export (CLI)","correct":"npx tronscan-test test"},{"note":"The MCP server binary is `tronscan-test-mcp`. Using `npx tronscan-test mcp` may also work via CLI but is not the canonical MCP entry.","wrong":"npx tronscan-test mcp","symbol":"MCP Server","correct":"npx tronscan-test-mcp"},{"note":"tronscan-test does not export Playwright fixtures; use @playwright/test directly.","wrong":"import { test, expect } from 'tronscan-test'","symbol":"Playwright fixtures (if used)","correct":"import { test, expect } from '@playwright/test'"}],"quickstart":{"code":"npx tronscan-test init my-tests && cd my-tests && npm install -D @playwright/test typescript @types/node && npx playwright install chromium && npx tronscan-test test","lang":"bash","description":"Initializes a test project, installs Playwright and TypeScript, downloads Chromium, and runs all 47 test cases."},"warnings":[{"fix":"Run: npm install -D @playwright/test@latest","message":"@playwright/test version must be >=1.56.0 for compatibility with tronscan-test.","severity":"gotcha","affected_versions":"<1.56.0"},{"fix":"Always run `npx tronscan-test-mcp` from the directory where `tronscan-test init` was executed.","message":"The 'mcp' command must be run from the project root; otherwise MCP server may not find test configuration.","severity":"gotcha","affected_versions":">=1.0"},{"fix":"Use `npx tronscan-test-mcp` for MCP server.","message":"Using `npx tronscan-test mcp` instead of `npx tronscan-test-mcp` is deprecated as of v1.4.0.","severity":"deprecated","affected_versions":">=1.4.0"},{"fix":"Use Xvfb or run headlessly in CI.","message":"Headed mode (--headed) may fail in CI environments without a display server.","severity":"gotcha","affected_versions":">=1.0"},{"fix":"Run init in an empty directory or use a new folder name.","message":"Test initialization creates a directory; avoid running over existing projects.","severity":"gotcha","affected_versions":">=1.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Install with: npm install -D @playwright/test@latest","cause":"@playwright/test is not installed or version is too old.","error":"Could not resolve '@playwright/test'"},{"fix":"Run: npx tronscan-test init or install globally with: npm install -g tronscan-test","cause":"tronscan-test is not installed globally or locally.","error":"Error: Cannot find module 'tronscan-test-mcp'"},{"fix":"Run: npx playwright install chromium","cause":"Playwright browsers not installed.","error":"Error: Failed to launch browser: Executable doesn't exist at ..."},{"fix":"Update Playwright: npm install -D @playwright/test@latest","cause":"Incompatible Playwright version.","error":"Error: @playwright/test version 1.4x is not supported. Required >=1.56.0"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}