A code coverage instrumenter for UI5-tooling using NYC
npm install ui5-middleware-code-coveragebash
npm install ui5-middleware-code-coverage --save-dev
`
Configuration options (in
$yourapp/ui5.yaml)
- baseUri: string
the baseUri to proxy
Usage
1. Define the dependency in $yourapp/package.json:
`json
"devDependencies": {
"ui5-middleware-code-coverage": "*"
},
"ui5": {
"dependencies": [
"ui5-middleware-code-coverage"
]
}
`
> As the devDependencies are not recognized by the UI5 tooling, they need to be listed in the ui5 > dependencies array. In addition, once using the ui5 > dependencies array you need to list all UI5 tooling relevant dependencies.
2. configure it in $yourapp/ui5.yaml:
`yaml
server:
customMiddleware:
- name: ui5-middleware-code-coverage
afterMiddleware: compression
mountPath: /
configuration:
path: "webapp"
enabled: "false"
exclude: "test,resources"
`
The path is which folder you want to cover. The enabled is whether you want to switch the coverage on or off. Handy when you are doing development as the instrumented code is a bit messy.
The exclude is if you want to exclude any folders from the code coverage, such as the test folder. This feature is optional
How it works
The middleware will launch another express nodejs server that will act as a collector and instrumenter for your code. The path in the yaml configuration tells the package which folder and subsequent JS files needs to be instrumented for code coverage.
The coverage is stored in your browser session in the window.__coverage__ object. You can use this plugin together with Selenium and after execution of your scripts submit the code coverage or you can simply use it manually and after your testing submit the coverage to the server using below snippet.
`
$.ajax({
type: "POST",
url: 'http://localhost:3000/coverage/client',
data: JSON.stringify(window.__coverage__),
headers: {
'Accept': 'application/json',
'Content-Type': 'application/json'
}
});
`
The Coverage service
The above snippet adds the following endpoints to your app under /coverage`
| URL | Description |
|---|---|
GET / |
Dynamic code coverage HTML report showing live coverage. Clickable with drill-downs just like the static version |
POST /reset |
Reset coverage to baseline numbers |
GET /download |
Download a zip file with coverage JSON, HTML and lcov reports |
POST /client |
Allows you to post a coverage object for client-side code coverage from the browser. Must be a JSON object with a Content-type: application/json header.
This object is aggregated with the stats already present on the server |