Ways to Write Tests
Video to Step Generation
Simply drop in a video file, or paste a Loom Recording Link and we’ll generate the test steps for you.
Writing Steps Manually
Write your tests yourself, step by step! Useful for trickier flows, or high-level tests.
Script to Step Generation
Upload a script and we’ll create test steps.
Creating Your Test
1
Fill Basic Test Information
Start with the essential details:
- Test Name: Give your test a clear, descriptive title for internal organization
- Test Description: Add detailed context about the test’s purpose
- Test URL: The starting URL of your test (complete path, e.g., https://your-domain-name.com)
- Viewport Size: Choose the screen size for test execution (e.g., MacBook Pro 15”)
2
Configure Test Settings
Set up your test configuration:
-
Authentication Settings:
- Start from logged-in state: Begin test using login state from another test
- Save login state: Make this test’s login state available for other tests
- Learn more about authentication configuration
Using a custom authentication setup? If you encounter any issues, the Spur team is here to help optimize your configuration. Don’t hesitate to reach out for personalized assistance.
-
File Upload Configuration:
- Include files for upload: Add files needed during test execution
-
Caching Options:
- Enable caching for faster test execution
- Learn more about caching
Authentication configuration is crucial for tests that require user login states. See our authentication guide for detailed setup instructions.
3
Add Dependencies & Teardowns
Configure test prerequisites and cleanup:Dependencies
- Select tests that need to run before your test
- Dependencies are recursive - if your selected test has dependencies, they’ll be included
- These run at the END to reset your application state
- Example: If your test uploads a file, the teardown should delete it
- Mark tests as teardown tests to make them available for other tests
Teardown Tests are Critical
Always set up appropriate teardown tests to maintain a clean test environment4
File Uploads
For tests requiring file uploads:
- Specify the files needed for the test
- Files must be under 5MB each
- Ensure proper file paths and permissions
File upload capability is essential for completing tests that interact with file inputs
Best Practices
- Clear Naming: Use descriptive names for your tests
- Proper Verification: Include VERIFY statements for critical checkpoints
- Clean Teardown: Always include cleanup steps
- Modular Design: Break complex flows into smaller, reusable tests
- Proper Dependencies: Configure test dependencies correctly