Skip to content

Latest commit

 

History

History
114 lines (93 loc) · 2.7 KB

README.md

File metadata and controls

114 lines (93 loc) · 2.7 KB

mapbender-testing

Cypress for Mapbender

Configuration

The following parameters must be entered in cypress.config.js.

  • title : 'Mapbender Demo Cypress',
  • slug : 'Mapbender_Demo_CYPRESS',
  • user: 'root',
  • password: 'root',
  • mainUrl: 'http://localhost/mapbender4/',

Explanation:
title: Application name for the test
slug: Part of the url for the test application
user: for login
password: for login
mainUrl: which application is to be tested

To be able to read the parameters, they must be added in json format under env -> application.
Example:

    env : {
      application : {
        title : 'Mapbender Demo Cypress',
        slug : 'Mapbender_Demo_CYPRESS',
        user: 'username',
        password: 'password',
        mainUrl: 'http://localhost/mapbender/',
        layer : {
            1 : 'Themen'
        },
      },
    }

Here is an example of a complete cypress.config.js

const { defineConfig } = require("cypress");

module.exports = defineConfig({

  e2e: {
    baseUrl: 'http://localhost',
    experimentalRunAllSpecs: true,
    env : {
      application : {
        title : 'Mapbender Demo Cypress',
        slug : 'Mapbender_Demo_CYPRESS',
        user: 'username',
        password: 'password',
        mainUrl: 'http://localhost/mapbender/',
        layer : {
            1 : 'Themen'
        },
      },
    },
  },
});

The other parameters are Cypress specific and can be found here: https://docs.cypress.io/app/references/configuration

It is possible that the tests must be language-dependent. To do this, it must be ensured that the mapbender is started in the corresponding language:

Customise the paramters.yaml for this.

parameters:  
    \# locale en, de, es, fr, it, nl, pt, ru, tr, uk are available  
    fallback_locale: de  
    locale: de  
    \# uncomment this if you don't want the language to automatically adapt to the browser language  
    mapbender.automatic_locale: false

Installation Cypress

Node.js and npm:
Make sure Node.js and the package manager npm (or alternatively yarn or pnpm) are installed on your system.
If not, you can install them via the package management system:

Ubuntu/Debian

sudo apt update
sudo apt install nodejs npm

Install Cypress in a Directory of your Choice

npm install cypress --save-dev

You can also use yarn or pnpm:

# yarn
yarn add cypress --dev

# pnpm
pnpm add --save-dev cypress

Open Cypress

npx cypress open

Then select E2E Testing in the window that opens

For more information please visit the official cypress documentation.

Official documentation

The official documentation can be found here: docs.cypress.io.