Fast, scalable and robust testing solution for the ever-evolving web landscape.
Testplane (ex-Hermione) is a battle-hardened framework for testing web apps at any scale, any browser and any platform.
🧑💻 Developer Friendly: Enjoy a hassle-free start with our installation wizard, TypeScript support, instant feedback via live test editing, advanced HTML-reporter, and smart features like auto-wait and retries.
📸 Visual Testing Redefined: Capture anything from specific details to whole pages, manage diffs with a streamlined UI, explore a variety of diff modes and let Testplane tackle flakiness.
🌐 Test Across Environments: Forget being tied to a couple of latest Chrome builds. Testplane goes beyond that, offering testing on real devices and broad automation protocol support, mirroring your users' actual environments.
📈 Scale Effortlessly: Run thousands of tests on a remote browser grid or benefit from ultra-fast local execution. Testplane offers sharding, parallel test execution, and isolated browser contexts.
⚡ Infinite Extensibility: Testplane offers a versatile plugin system with dozens of open-source plugins on GitHub, along with custom reporters, commands, and execution logic.
Note: if you prefer manual installation, you can run
npm i -D testplane. Check out the Docs for details.
Use the CLI wizard to set up testplane and generate basic configuration:
npm init testplane@latest new-testplane-project
You may add -- --verbose argument to launch a tool in extra-questions mode, to pick custom package manager or install extra plugins.
Open the newly generated file testplane-tests/example.testplane.ts. We’ll modify the test to ensure the description includes expected text:
describe("test", () => {
it("example", async ({browser}) => {
await browser.url("https://example.com/");
const description = await browser.$("p");
expect(description).toHaveTextContaining("for use in illustrative examples in documents");
});
});
Launch GUI:
npx testplane gui
Try running the test and watch it pass. Now, let's replace description text check with a visual assertion. Use the assertView command to carry out visual checks:
- expect(description).toHaveTextContaining("for use in illustrative examples in documents");
+ await description.assertView("description"); // "description" is just a name of the assertion
Run the test again. It will fail, because a reference image for the heading is missing. You can accept the diff and re-run the test, it will then pass.
Congratulations on writing your first Testplane test, which navigates to a page and executes a visual assertion. Dive into the Docs to discover more awesome features Testplane has to offer!
The documentation is divided into several sections:
This project was formerly known as "Hermione", but eventually some copyright and trademark issues surfaced, leading to the decision to rebrand. After some discussion, we settled on "Testplane" as the official new title. Considering this change as merely a rebranding, we've proceeded with the existing version count instead of starting anew. Thus, Testplane v8.x is a drop-in replacement for Hermione v8.x.
Learn more about migration from Hermione to Testplane in the Docs.
Our mission with this repository is to make the Testplane development process open, while continuing to improve upon its features, performance and ease of use. We hope other organizations find value in our project and benefit from our work.
We welcome and appreciate community contributions. To ensure our efforts are in sync, we recommend to raise an issue or leave a comment beforehand.
Visit our contributing guide to understand more about our development process and how to get involved.
Testplane is MIT licensed.
FAQs
Tests framework based on mocha and wdio
The npm package testplane receives a total of 1,176 weekly downloads. As such, testplane popularity was classified as popular.
We found that testplane demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
A malicious npm package disguised as a WhatsApp client is exploiting authentication flows with a remote kill switch to exfiltrate data and destroy files.
Security News
PyPI now supports digital attestations, enhancing security and trust by allowing package maintainers to verify the authenticity of Python packages.
Security News
GitHub removed 27 malicious pull requests attempting to inject harmful code across multiple open source repositories, in another round of low-effort attacks.