E2E Testing Framework for Invenio

Note: This is a suggestion only; it might be changed or abandoned at any time.

Dependencies

• Node.js (v20.11.0 or higher)
• pnpm (v9.0.0 or higher)

How to Try It Out

Directory Structure

At the beginning, you have just your repository:

parent-directory
  +-- <my-repository>
        +-- site

You will need to change it to the following structure:

parent-directory
  +-- <my-repository>
         +-- e2e
         +-- site
  +-- invenio-e2e
         +-- ...
  +-- pnpm-workspace.yaml

Steps

1. Create a pnpm-workspace.yaml file in parent directory:

   # pnpm-workspace.yaml
   packages:
     - <my-repository>/e2e
     - invenio-e2e

2. Clone the invenio-e2e repository from GitHub:

   gh repo clone oarepo/invenio-e2e
   # Switch to a feature branch if needed

3. Create the e2e directory inside your repository:

   gh repo clone mesemus/sample-e2e-repository temp-repository
   mv temp-repository/e2e <my-repository>/e2e
   rm -rf temp-repository

4. Install dependencies:

   cd <my-repository>/e2e
   pnpm install

5. Configure environment variables (see src/config/env.ts for all options):

   You will need a test user that can deposit records in your InvenioRDM instance.

   export INVENIO_USER_EMAIL=...
   export INVENIO_USER_PASSWORD=...

6. Run your server in another terminal:

   cd <my-repository>
   invenio-cli run

7. Run tests:

   cd <my-repository>/e2e
   npx playwright test

API Testing

The project also ships with a lightweight API regression suite that reuses the same authentication helpers as the UI tests.

1. Generate an authenticated storage state once by running:

   npx playwright test tests/api/auth.setup.ts

   The state is saved to tests/playwright/.auth/user.json by default. Override the destination by setting the AUTH_USER_FILE_PATH environment variable.

2. Execute the API suite:

   npx playwright test tests/api/invenio-api.spec.ts

   Requests target various endpoints like /api/records unless you provide a different base URL. See the JSDoc in src/tests/api for additional customization options.