CSV data reading in Selenium Java - Framework Patterns

Framework Mode - CSV data reading

Folder Structure

src/
 └── test/
      └── java/
           ├── com/
           │    └── example/
           │         ├── pages/           # Page Object classes
           │         ├── tests/           # Test classes
           │         ├── utils/           # Utility classes (CSV reader, helpers)
           │         └── config/          # Configuration classes
      └── resources/
           └── testdata/
                └── testdata.csv        # CSV test data files

Test Framework Layers

• Driver Layer: Manages WebDriver setup and teardown for browser control.
• Page Objects: Encapsulate web page elements and actions for reusability.
• Tests: Test classes that use page objects and data from CSV files to run tests.
• Utilities: Helper classes like CSVReader to read and parse CSV files into usable data.
• Config: Holds environment settings, browser options, and credentials.

Configuration Patterns

• Environment Properties: Use config.properties or Java classes to define URLs, browsers, and credentials.
• CSV Data Location: Store CSV files under src/test/resources/testdata/ for easy access.
• Data Access: Use utility classes to read CSV files and convert rows into objects or maps for tests.
• Browser Setup: Configure browser type and options in config classes or test setup methods.

Test Reporting and CI/CD Integration

• Use TestNG or JUnit reports to generate XML/HTML test result files.
• Integrate with CI tools like Jenkins or GitHub Actions to run tests automatically on code changes.
• Include CSV data-driven tests in CI pipelines to validate multiple data scenarios.
• Use logging frameworks (e.g., Log4j) to capture detailed test execution info.

Best Practices

1. Keep CSV files small and focused: One CSV per test scenario to simplify maintenance.
2. Use a dedicated CSV reader utility: Centralize CSV parsing logic to avoid duplication.
3. Map CSV rows to POJOs: Convert CSV data into plain Java objects for type safety and clarity.
4. Separate test data from test logic: Keep CSV files outside source code folders.
5. Validate CSV data format: Add checks in the CSV reader to handle missing or malformed data gracefully.

Self Check

Where in this folder structure would you add a new utility class to parse a CSV file for test data?

Key Result

Organize CSV data reading in a Selenium Java framework by placing CSV files in resources, using utility classes for parsing, and separating test data from test logic.