Web3 & DApp Development Fundamentals · Leçon

Couverture et rapports de gas

Indicateurs de qualité

Couverture et rapports de gas est une leçon Web3 & DApp Development Fundamentals gratuite sur CoddyKit. Ceci est la leçon 3 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Web3 & DApp Development Fundamentals, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Web3 & DApp Development Fundamentals comprend 4 leçons au total.

Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.

Quality Metrics

Two metrics help judge contract quality:

Code coverage — how much of your Solidity is exercised by tests.
Gas usage — how expensive your functions are to call.

Both are available as Hardhat plugins, and the Toolbox includes the gas reporter.

What Coverage Tells You

Coverage measures the percentage of statements, branches, and functions touched by your tests.

Low coverage means untested code paths — potential hidden bugs.
100% coverage does not guarantee correctness, but gaps are red flags.

Installing Coverage

The solidity-coverage plugin instruments your contracts and reports coverage:

npm install --save-dev solidity-coverage

Then require it in your config:

require("solidity-coverage");

npm install --save-dev solidity-coverage
// in hardhat.config.js:
require("solidity-coverage");

Running Coverage

Run the coverage task to execute your tests with instrumentation:

npx hardhat coverage

It prints a table per file and writes an HTML report to coverage/ you can open in a browser.

npx hardhat coverage

Reading a Coverage Table

The report has four columns:

% Stmts — statements executed.
% Branch — if/else branches taken.
% Funcs — functions called.
% Lines — lines reached.

Branch coverage is often the hardest to fill — make sure both sides of every condition are tested.

The Gas Reporter

The hardhat-gas-reporter (in the Toolbox) prints gas costs for each function call during tests. Enable it in config:

module.exports = {
  gasReporter: {
    enabled: true,
  },
};

It outputs a table after npx hardhat test.

module.exports = {
  gasReporter: {
    enabled: true,
  },
};

Reading the Gas Table

The gas report shows, per method:

Min / Max / Avg gas across calls.
# calls — how often it ran in tests.
Deployment cost for each contract.

Functions that vary widely between min and max often have conditional logic worth examining.

Pricing in Fiat

The gas reporter can show estimated costs in real money by fetching a gas price and token price:

gasReporter: {
  enabled: true,
  currency: "USD",
  gasPrice: 30,
}

This helps you communicate the real cost of operations to stakeholders.

gasReporter: {
  enabled: true,
  currency: "USD",
  gasPrice: 30,
}

Toggling with Env Vars

Coverage and gas reporting slow tests down, so gate them behind an environment variable:

gasReporter: {
  enabled: process.env.REPORT_GAS === "true",
}

Run REPORT_GAS=true npx hardhat test only when you need the report.

gasReporter: {
  enabled: process.env.REPORT_GAS === "true",
}

Using Metrics in CI

In continuous integration you can:

Fail the build if coverage drops below a threshold.
Comment gas diffs on pull requests.

These guardrails keep quality from silently regressing as the codebase grows.

Outputting to a File

The gas reporter can write its table to a file for archiving or diffing in CI:

gasReporter: {
  enabled: true,
  outputFile: "gas-report.txt",
  noColors: true,
}

Disabling colors keeps the file readable. Coverage similarly produces a coverage/ HTML report and an lcov.info file.

gasReporter: {
  enabled: true,
  outputFile: "gas-report.txt",
  noColors: true,
}

Quick Check

Test your understanding of coverage and gas reports.

Recap

You learned to measure test and gas quality.

solidity-coverage reports statement, branch, function, and line coverage via npx hardhat coverage.
Branch coverage best reveals untested paths.
The gas reporter (in the Toolbox) prints per-method gas and deployment costs.
It can price calls in fiat and be toggled with an env var.
Enforce thresholds in CI to prevent regressions.

Questions Fréquemment Posées

La leçon « Couverture et rapports de gas » est-elle gratuite ?

Oui — le texte complet de « Couverture et rapports de gas » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Web3 & DApp Development Fundamentals, passe à CoddyKit PRO. Le cours Web3 & DApp Development Fundamentals comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Couverture et rapports de gas » ?

Indicateurs de qualité Tu pratiques Web3 & DApp Development Fundamentals avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Web3 & DApp Development Fundamentals ?

Aucune expérience préalable n'est requise. Web3 & DApp Development Fundamentals sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 3 sur 4.

Combien de temps prend la leçon « Couverture et rapports de gas » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Web3 & DApp Development Fundamentals ?

Oui. Chaque leçon Web3 & DApp Development Fundamentals inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à Web3 & DApp Development Fundamentals