Configuration options

Qase reporters support primarily two configuration methods: (although some reporters allow CLI options)

  • A configuration File (qase.config.json or .qaserc)
  • Environment Variables

The configuration system uses a priority hierarchy where environment variables override configuration file values, and both can be further overridden by direct options passed to the reporter.

direct CLI options in the run command > environment variables > options in config file

The reporters look for the config file in your project's root directory.


Common options

DescriptionConfig fileEnvironment variableDefault valueRequiredPossible values
Mode of reportermodeQASE_MODEoffNotestops, report, off
Fallback mode of reporterfallbackQASE_FALLBACKoffNotestops, report, off
EnvironmentenvironmentQASE_ENVIRONMENTundefinedNoAny string
Root suiterootSuiteQASE_ROOT_SUITEundefinedNoAny string
Enable debug logsdebugQASE_DEBUGFalseNoTrue, False
Enable capture logs from stdout and stderrcaptureLogsQASE_CAPTURE_LOGSFalseNoTrue, False

TestOps configuration

DescriptionConfig fileEnvironment variableDefault valueRequiredPossible values
Token for API accesstestops.api.tokenQASE_TESTOPS_API_TOKENundefinedYesAny string
Qase API host. For enterprise users, specify full address: api-example.qase.iotestops.api.hostQASE_TESTOPS_API_HOSTqase.ioNoAny string
Qase enterprise environmenttestops.api.enterpriseQASE_TESTOPS_API_ENTERPRISEFalseNoTrue, False
Code of your project, which you can take from the URL: https://app.qase.io/project/DEMO - DEMO is the project codetestops.projectQASE_TESTOPS_PROJECTundefinedYesAny string
Qase test run IDtestops.run.idQASE_TESTOPS_RUN_IDundefinedNoAny integer
Qase test run titletestops.run.titleQASE_TESTOPS_RUN_TITLEAutomated run <Current date and time>NoAny string
Qase test run descriptiontestops.run.descriptionQASE_TESTOPS_RUN_DESCRIPTION<Framework name> automated runNoAny string
Qase test run completetestops.run.completeQASE_TESTOPS_RUN_COMPLETETrueTrue, False
Qase test plan IDtestops.plan.idQASE_TESTOPS_PLAN_IDundefinedNoAny integer
Size of batch for sending test resultstestops.batch.sizeQASE_TESTOPS_BATCH_SIZE200NoAny integer
Enable defects for failed test casestestops.defectQASE_TESTOPS_DEFECTFalseNoTrue, False

Report configuration

DescriptionConfig fileEnvironment variableDefault valueRequiredPossible values
Driver used for report modereport.driverQASE_REPORT_DRIVERlocalNolocal
Path to save the reportreport.connection.pathQASE_REPORT_CONNECTION_PATH./build/qase-report
Local report formatreport.connection.formatQASE_REPORT_CONNECTION_FORMATjsonjson, jsonp

Example qase.config.json config:

{  
  "mode": "testops",  
  "fallback": "report",   
  "debug": false,  
  "environment": "production",  
  "testops": {  
    "api": {  
      "token": "your-api-token",  
      "host": "qase.io"  
    },  
    "project": "your-project-code",  
    "run": {  
      "title": "Automated Test Run",  
      "description": "Regression test suite",  
      "complete": true,  
      "tags": ["regression", "automated"]  
    },  
    "uploadAttachments": true,  
    "plan": {  
      "id": 123  
    },  
    "batch": {  
      "size": 200  
    },  
    "defect": true,  
    "configurations": {  
      "values": [  
        {  
          "name": "browser",  
          "value": "chrome"  
        }  
      ],  
      "createIfNotExists": true  
    }  
  },  
  "report": {  
    "driver": "local",  
    "connections": {  
      "local": {  
        "path": "./test-results",  
        "format": "json"  
      }  
    }  
  }  
}