# Gerrit Code Review - JavaScript Plugin Checks API

version v3.4.4

This API is provided by plugin.checks(). It allows plugins to contribute to the "Checks" tab and summary:

Each plugin can register a checks provider that will be called when a change page is loaded. Such a call would return a list of `Runs` and each run can contain a list of `Results`.

The details of the ChecksApi are documented in the source code. Note that this link points to the `master` branch and might thus reflect a newer version of the API than your Gerrit installation.

If no plugins are registered with the ChecksApi, then the Checks tab will be hidden.

You can read about the motivation, the use cases and the original plans in the design doc.

Here are some examples of open source plugins that make use of the Checks API:

- Gerrit Checks Plugin

- Chromium Buildbucket Plugin

- Chromium Coverage Plugin

## register

`checksApi.register(provider, config?)`

Params

- provider Must implement a `fetch()` interface that returns a `Promise<FetchResponse>` with runs and results. See also documentation in the source code.

- config Optional configuration values for the checks provider.

## announceUpdate

`checksApi.announceUpdate()`

Tells Gerrit to call `provider.fetch()`.