chromium/third_party/blink/renderer/modules/badging/README.md

# Badging

This module contains the implementation of the [Badging API].

[Badging API]: https://github.com/WICG/badging
[active development]: https://crbug.com/719176

### API

See the [explainer] for details. The NavigatorBadge mixin interface is
included by Navigator and WorkerNavigator, which exposes two methods:
setAppBadge() and clearAppBadge().

[explainer]: https://github.com/WICG/badging/blob/master/explainer.md

*  `setAppBadge(optional [EnforceRange] unsigned long long contents)`: Sets the
associated app's badge to |contents|.
   * When |contents| is omitted, sets the associated app's badge to "flag".
   * When |contents| is 0, sets the associated app's badge to nothing.
*  `clearAppBadge()`: Sets the associated app's badge to nothing.

### Testing

`web_tests/badging/*.html` tests that the API accepts/rejects the appropriate
inputs (with a mock Mojo service that verifies that the interface sends the
correct Mojo messages". These tests duplicate some of the tests from WPT (below)
but with internal verification.

`web_tests/external/wpt/badging/*.html` tests that the API accepts/rejects the
appropriate inputs. These tests do not test the internal state of the badge
(because they have no visibility into it), only success/failure.