Codecov Browser Extension
Line coverage on commits and Pull Requests, directly on GitHub
Introduction
Codecov has a native browser extension that works with both Google Chrome (as a browser extension) and Mozzilla Firefox (as an add-on). The extension can be installed directly from the following locations:
- For Google Chrome, the Chrome Web Store.
- For Mozilla Firefox, the Firefox Add-Ons Portal
The browser extension is also open source, and feedback, bugs, and feature requests can be submitted directly to its GitHub Issues page.
Finally, the browser extension supports both cloud and on premises versions of GitHub and Codecov. Support for GitLab and Bitbucket is currently not available.
Installation
Installation is identical to any other Chrome Extension or Firefox Add-On:
Setup
For Codecov Cloud and GitHub Cloud
To use the extension with github cloud (i.e., https://github.com) and codecov cloud (i.e., https://codecov.io/) ensure that you are logged into each service. Once logged in, you can visit any repository on GitHub and view line coverage on any commit or Pull Request.
For Self-Hosted Installations
For use against self-hosted installations of GitHub and Codecov, additional configuration is required. This configuration can be provided from the Settings Panel of the extension. To access the Settings Panel, simply click on the extension's icon in your browser's toolbar.
Once "Use self hosted instance" is enabled, additional configuration options will be presented:
The following fields are required:
- Codecov URL - the URL of your Codecov Self-Hosted installation
- Codecov API Token - A Codecov API token. This token can be generated from the user settings page of your Codecov installation.
- GitHub URL - the URL of your GitHub installation
Make sure to Grant Permissions to the Extension
Once you have provided the above information to the extension, the "Grant Permissions" button should be clicked while the self-hosted installation of GitHub is loaded as the active tab in the browser.
Once accomplished, the browser extension should provide line coverage directly within your GitHub Enterprise instance. Note that the above instructions also apply for self-hosted installations of Codecov paired with GitHub Cloud. In this case, the GitHub URL would be https://github.com.
Additional Functionality
Line Coverage for Flags and Components
In addition to displaying line coverage for commits and Pull Requests, the browser extension also supports Codecov Flags and Components if the repository being viewed uses them. Line coverage can be filtered via selecting Flags or Components from their associate dropdown menus in the GitHub UI.
Updated 12 months ago