Package Exports

@nextcloud/e2e-test-server
@nextcloud/e2e-test-server/commands
@nextcloud/e2e-test-server/cypress
@nextcloud/e2e-test-server/docker
@nextcloud/e2e-test-server/playwright
@nextcloud/e2e-test-server/selectors

Readme

@nextcloud/e2e-test-server

Codecov

Nextcloud e2e test server and utils for cypress and playwright.

Status

This package is currently work in progress and will change significantly until version 1.0. In particular cypress specific utils such as selectors will be dropped unless they are widely used.

Starting Nextcloud Docker container

Playwright

Copy playwright.config.mjs and playwright folder from this repository!
Add the @playwright/test dependency:

  npm install --save-dev '@playwright/test'

Add the start:nextcloud script to your package.json

  {
    "start:nextcloud": "node playwright/start-nextcloud-server.mjs",
  }

Install chromium for playwright:

  npx playwright install chromium --only-shell

Run playwright tests:

  npx playwright test

Add .github/workflows/playwright.yml to your repository!
Write your own tests!

Cypress

You can use the cypress folder and the cypress.config.ts in this repository as starting points or adjust your cypress.config.ts (or .js):

import { configureNextcloud,  startNextcloud,  stopNextcloud, waitOnNextcloud } from '@nextcloud/e2e-test-server'

export default defineConfig({
// ...
    e2e: {
        // other configuration

        setupNodeEvents(on, config) {
            // Remove container after run
            on('after:run', () => {
                stopNextcloud()
            })

            // starting Nextcloud testing container with specified server branch
            return startNextcloud(process.env.BRANCH)
                .then((ip) => {
                    // Setting container's IP as base Url
                    config.baseUrl = `http://${ip}/index.php`
                    return ip
                })
                .then(waitOnNextcloud)
                // configure Nextcloud, also install and enable the `viewer` app
                .then(() => configureNextcloud(['viewer']))
                .then(() => {
                    return config
                })
        },
    },
})

Cypress commands

You can import individual commands or all at once You can find the list of all available commands here

// cypress/support/commands.js
import { addCommands } from '@nextcloud/e2e-test-server/cypress'

addCommands()

// cypress/support/commands.js
import { login } from '@nextcloud/e2e-test-server/commands'

Cypress.Commands.add('login', login)

Selectors (:warn: deprecated)

You can find the list of all available selectors here

import { UploadPicker as UploadPickerComponent} from '../../dist/index.js'
import { UploadPicker, UploadPickerInput } from '@nextcloud/e2e-test-server/selectors'

describe('UploadPicker rendering', () => {
    it('Renders default UploadPicker', () => {
        cy.mount(UploadPickerComponent)
        cy.getNc(UploadPicker).should('exist')
            .should('have.class', 'upload-picker')
        cy.getNc(UploadPickerInput).should('exist')
    })
})