# CodeceptJS

CodeceptJS is a tool that automatically tests your websites and apps to ensure they work correctly. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5262/codeceptjs

## Description

CodeceptJS is a tool that automatically tests your websites and apps to ensure they work correctly. It mimics real human actions—like clicking buttons or typing—to catch errors before your users do. It connects with various technologies to test across all web browsers and mobile devices.

## Platform availability

Available on 0 of 10 platforms.

## Health score

71/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 3 days ago)
- Popular: 73 (4,253 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Security check: 58 (no serious findings, 8 minor, CI, tests, OpenSSF Scorecard 4.7/10)

## Links

- GitHub: https://github.com/codeceptjs/CodeceptJS
- Docker Hub: https://hub.docker.com/r/codeception/codeceptjs
- Official website: http://codecept.io
- Documentation: http://codecept.io/basics

## Common questions

### Do CodeceptJS browser tests need an extra package in the project?

Yes, Playwright must be installed alongside CodeceptJS. Without it, browser tests can't start.

### Can tests target elements with locators other than plain CSS selectors?

Yes, examples show XPath, CSS, and role/name locators for clicking and interacting with elements.

### Can tests wait for text or elements before continuing?

Yes, CodeceptJS includes waitForText and waitForElement methods that accept a timeout value.

### Can tests upload a file to a form field?

Yes, I.attachFile can attach a file to a selected element, such as an avatar input.

### Does CodeceptJS attempt to repair failing tests automatically?

It is described as using self-healing to try to fix a test before failing it.

## Alternatives

- Selenium: Selenium is a suite of tools specifically for testing web applications.
- puppeteer: Puppeteer is a Node library which provides a high-level API to control headless Chrome or Chromium over the DevTools Protocol.

---
Source: Our Local Host (https://ourlocalhost.com/app/5262/codeceptjs), the self-hosted and open-source app directory.
