Before running your test suites, ensure you have the required tools installed for your target platforms.
1. General Requirements
Section titled “1. General Requirements”To run the zenitest CLI on your machine:
- Node.js: Version 18 or higher (or Bun / pnpm / yarn)
- ZeniTest CLI: Installed globally via
npm install -g zenitest - ZeniTest API Key: Get your API key from the ZeniTest dashboard
2. Web Testing Requirements
Section titled “2. Web Testing Requirements”To run web browser tests:
- Automatic Browser Installation: You do not need to manually install or manage browser drivers. When you run a web test, ZeniTest will automatically download and install the required browser (Chromium, Firefox, or WebKit) if it is not already present on your machine.
- Supported Browsers:
- Chromium (Default)
- Google Chrome (Uses system Chrome if installed)
- Mozilla Firefox
- WebKit / Safari
Tip: You don’t need WebDriver binaries, ChromeDriver, or Selenium servers. Everything runs out of the box.
3. Android Testing Requirements
Section titled “3. Android Testing Requirements”To run tests on Android mobile applications:
- Android Studio & SDK:
- Install Android Studio.
- Ensure
ANDROID_HOMEorANDROID_SDK_ROOTis set in your environment, withplatform-tools(containingadb) added to yourPATH.
- An Active Device:
- Android Emulator: An AVD (Android Virtual Device) created in Android Studio and running.
- OR a Physical Device: Connected via USB with USB Debugging enabled in Developer Options.
- App Binary: Built
.apkfile (e.g../build/app-debug.apk).
4. iOS Testing Requirements
Section titled “4. iOS Testing Requirements”To run tests on iOS mobile applications:
- macOS: An Apple Mac computer running macOS.
- Xcode:
- Install Xcode from the Mac App Store.
- Install Xcode Command Line Tools:
Terminal window xcode-select --install
- An Active Device:
- iOS Simulator: Launched via Xcode or Simulator app.
- OR a Physical iPhone / iPad: Connected to your Mac with Developer Mode enabled.
- App Binary: Built
.app(for Simulators) or.ipa(for Physical Devices).
Quick Summary Table
Section titled “Quick Summary Table”| Platform | Required Software | Device / Runtime | Target |
|---|---|---|---|
| Web | Node.js (18+) | Auto-installed (Chromium / Firefox / WebKit) | URL set in config.yaml |
| Android | Android Studio & SDK (adb) |
Android Emulator or USB Device | .apk |
| iOS | macOS & Xcode | iOS Simulator or USB iPhone | .app / .ipa |