极速阅览

To start you will need the following:

A code host (we'll be using Github in our example here)
A repository
Tested code within that repository
A Codecov account

For easy reference here is our JavaScript Example repo that we will reference throughout the walk-through.

Getting test coverage with Jest

We will be taking advantage of the jest package to run our tests. We will need to create a package.json file.

{ "name": "@codecov/example-javascript", "version": "0.0.1", "description": "Codecov Example Javascript", "scripts": { "test": "jest" }, "devDependencies": { "jest": "^28.1.1" } }

To run your tests, run npm install && npm run test in a terminal window.

--> npm install && npm run test … > @codecov/[email protected] test > jest PASS app/calculator.test.js ✓ add function (2 ms) Test Suites: 1 passed, 1 total Tests: 1 passed, 1 total Snapshots: 0 total Time: 0.762 s Ran all test suites.

To get coverage results, we will need to update our jest settings. Create a file jest.config.js with the following contents:

module.exports = { collectCoverage: true, coverageReporters: ['text', 'cobertura'], }

Install the dependencies and run the tests to view code coverage:

--> npm run test > @codecov/[email protected] test > jest PASS app/calculator.test.js ✓ add function (1 ms) ---------------|---------|----------|---------|---------|------------------- File | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s ---------------|---------|----------|---------|---------|------------------- All files | 80 | 100 | 50 | 80 | calculator.js | 80 | 100 | 50 | 80 | 5 ---------------|---------|----------|---------|---------|------------------- Test Suites: 1 passed, 1 total Tests: 1 passed, 1 total Snapshots: 0 total Time: 0.397 s, estimated 1 s

Note that we are showing 80% code coverage.

How to upload to Codecov

Now that you have collected coverage locally, let’s learn how to upload these reports to Codecov. Codecov is often used in conjunction with continuous integration (CI) systems to ensure that new code changes are adequately covered by tests.

We will be using GitHub Actions as the Ci and the Codecov Action to upload coverage reports.

Create a file called .github/workflows/ci.yml

name: Workflow for Codecov example-javascript on: [push, pull_request] jobs: run: runs-on: ubuntu-latest steps: - name: Checkout uses: actions/checkout@v2 - name: Set up Node 18 uses: actions/setup-node@v3 with: node-version: 18 - name: Install dependencies run: npm install - name: Run tests and collect coverage run: npm run test - name: Upload coverage to Codecov uses: codecov/codecov-action@v3

It is recommended that you install the Codecov app for this repository to prevent rate-limiting issues. Save your code and push up to GitHub.

git checkout -b 'initial-commit' git add . git commit -m 'Initial commit and upload coverage to Codecov' git push origin initial-commit

In GitHub, open the pull request and wait for CI and Codecov to finish running and analyzing. You should see the following pull request commit:

You should also see four status checks, two of which come from Codecov:

Our status checks page contains more information on the meaning of each status check. When you are ready, merge the pull request.

Covering uncovered code

Now that we can get coverage data in our pull request. Let’s take a look at how to increase coverage.

Let’s take a look at the coverage report from Codecov. Navigate to your repository from the Codecov UI. You should see a dashboard like this.

Notice that there are only 4 covered lines in the Code tree. If we click on app, and calculator.js, we’ll come to the file view:

From this view, we can tell that we haven’t written a test for our subtract function

Create a new branch in your terminal

git checkout main git pull git checkout -b 'subtract-test'

and replace the test file app/calculator.test.js with the following code.

const { add, subtract } = require('./calculator'); test('add function', () => { expect(add(1, 2)).toBe(3); }); test('subtract function', () => { expect(subtract(1, 2)).toBe(-1); });

Save the code and open a new pull request.

git add . git commit -m 'fix: add tests for subtract fn' git push origin subtract-test

Notice the Codecov comment shows the coverage increasing from 80.00% to 100.00%.

Advanced Codecov configurations

Now that you have uploaded your first Javascript coverage reports successfully to Codecov, you can check out some of our other features including

Configuring Codecov settings
Adding flags to isolate coverage reports
Labeling critical files

Getting Started

Concepts

Features

Reference

JavaScript Bundle Analysis

Codecov DEDICATED ENTERPRISE CLOUD

Codecov Self-Hosted

Site

Code coverage with JavaScript

Getting test coverage with Jest

How to upload to Codecov

Covering uncovered code

Advanced Codecov configurations