This extension contains generic widgets to be used to display remotely fetched json data.
Display a list of json keys/values.
key | required | description |
---|---|---|
title |
no | Override widget title, default to url value |
url |
yes | The URL to use to fetch the json |
headers |
no | An optional object containing http headers to send with the request |
Use a template to display json data.
key | required | description |
---|---|---|
title |
no | Override widget title, default to url value |
url |
yes | The URL to use to fetch the json |
headers |
no | An optional object containing http headers to send with the request |
template |
yes | The template to be used to display json data |
Display a status depending on json data.
key | required | description |
---|---|---|
title |
no | Override widget title, default to url value |
url |
yes | The URL to use to fetch the json |
headers |
no | An optional object containing http headers to send with the request |
template |
yes | The template to be used to display json data |
statuses |
yes | An array of rules used to define current status |
statuses[n].assert |
yes | The assertion to be made on fetched json data, see format |
statuses[n].status |
yes | Resulting status if assertion is met, must be one of: unknown , success , warning , error |
statuses[n].label |
no | An optional label to put under the status icon if assertion is met |
Assertions support several types:
checks that the resulting value strictly equals expectation
statuses:
- assert: equals(my_key, status_ok)
status: success
will check that my_key
equals status_ok
.
checks that the resulting value contains expectation
usage:
statuses:
- assert: contains(my_key, ok)
status: success
will check that my_key
is contains ok
.
checks that the resulting value matches regexp
usage:
statuses:
- assert: matches(my_key, (ok|success)$)
status: success
will check that my_key
is a matches regexp /(ok|success)$/
.
checks that the value results in a truthy value
usage:
statuses:
- assert: truthy(my_key)
status: success
will check that my_key
is a truthy value.
checks that the value results in a falsy value
usage:
statuses:
- assert: falsy(my_key)
status: error
will check that my_key
is a falsy value.