Grundlæggende udvikling af Web3- og DApp-programmer · Lektion

forge-test

Solidity-tests

Lektion 2 af 413 trin

forge-test er en gratis Grundlæggende udvikling af Web3- og DApp-programmer-lektion på CoddyKit. Dette er lektion 2 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i Grundlæggende udvikling af Web3- og DApp-programmer, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Grundlæggende udvikling af Web3- og DApp-programmer-kurset indeholder 4 lektioner i alt.

Tests er kontrakter

I Foundry er en testfil en Solidity-kontrakt, der nedarver fra Test i forge-std-biblioteket. Hver offentlig funktion, hvis navn begynder med test, køres som en separat test.

Testfiler ligger i test/ og bruger konventionelt suffikset .t.sol.

import {Test} from "forge-std/Test.sol";

contract CounterTest is Test {
    function testInitialZero() public {
        // ...
    }
}

Funktionen setUp

Den særlige funktion setUp() køres før hver test og giver hver test en frisk, isoleret tilstand. Udrul dine kontrakter, og opret eventuelle testdata her.

Da tilstanden nulstilles mellem tests, kan en test aldrig komme til at afhænge af en anden.

Counter counter;

function setUp() public {
    counter = new Counter();
}

Påstande

forge-std leverer hjælpere til assertioner, som får testen til at fejle med en tydelig meddelelse, når betingelserne ikke holder:

  • assertEq(a, b) — lighed
  • assertTrue(cond) / assertFalse(cond)
  • assertGt, assertLt, assertGe, assertLe
function testIncrement() public {
    counter.increment();
    assertEq(counter.number(), 1);
}

Kørsel af test

Kør hele testsamlingen med forge test. Filtrer efter navn med --match-test eller efter kontrakt med --match-contract. Øg detaljeringsgraden med flagene -v for at se logge og spor.

$ forge test
$ forge test --match-test testIncrement -vvv

Forventede reverts

Brug vm.expectRevert umiddelbart før et kald, der forventes at fejle. Testen består kun, hvis det næste kald reverterer, eventuelt med matchning af en bestemt fejlmeddelelse eller en brugerdefineret fejl.

function testOnlyOwner() public {
    vm.prank(address(0xBEEF));
    vm.expectRevert("not owner");
    counter.adminReset();
}

Efterligning af konti

vm.prank(addr) angiver msg.sender for det næste kald. vm.startPrank(addr) gælder for alle kald, indtil vm.stopPrank(). På den måde kan du teste adgangskontrol uden at deploye fra mange nøgler.

vm.startPrank(alice);
token.approve(spender, 100);
token.transfer(bob, 50);
vm.stopPrank();

Manipulation af saldi og tid

Cheatcodes giver dig kontrol over miljøet:

  • vm.deal(addr, amount) — angiv en kontos ETH-saldo
  • vm.warp(timestamp) — angiv block.timestamp
  • vm.roll(blockNum) — angiv block.number

Det gør det nemt at teste logik, der afhænger af tid og saldi, på en deterministisk måde.

vm.deal(alice, 10 ether);
vm.warp(block.timestamp + 7 days);
vm.roll(block.number + 100);

Test af hændelser

vm.expectEmit angiver, hvilke felter i hændelsen der skal kontrolleres, efterfulgt af den forventede hændelse og derefter det kald, der skal udløse den. Boolværdierne angiver, hvilke topics og data der skal matches.

vm.expectEmit(true, true, false, true);
emit Transfer(alice, bob, 100);
token.transfer(bob, 100);

Etiketter og logge

vm.label(addr, name) giver adresser læsbare navne i spor. console.log fra forge-std udskriver fejlfindingsoutput under test, når programmet køres med tilstrækkelig detaljeringsgrad.

import {console} from "forge-std/console.sol";

vm.label(alice, "Alice");
console.log("balance:", token.balanceOf(alice));

Test med fork

Foundry kan forke et aktivt netværk, så dine test køres mod rigtigt deployede kontrakter og deres tilstand. Angiv en RPC-URL, og brug vm.createSelectFork til at fastlåse en blok.

Det er uvurderligt til test af integrationer med protokoller som Uniswap eller Aave uden at deploye dem igen.

function setUp() public {
    vm.createSelectFork(vm.rpcUrl("mainnet"), 19000000);
}

Organisering af test

Gode fremgangsmåder til forge-test:

  • Én adfærd pr. testfunktion
  • Beskrivende navne som testRevertWhenNotOwner
  • Fælles opsætning i setUp()
  • Brug prank til adgangskontrol og warp til tidslogik
  • Tilføj fork-test til eksterne integrationer

Hurtigt tjek

Hvad er formålet med funktionen setUp() i en Foundry-testkontrakt?

Opsummering

Du har lært om forge-test:

  • Test er Solidity-kontrakter, der nedarver fra Test; funktioner begynder med test
  • setUp() giver en frisk tilstand for hver test
  • Assertioner: assertEq, assertTrue osv.
  • Cheatcodes: prank, deal, warp, expectRevert, expectEmit
  • Fork-test køres mod tilstanden på et aktivt netværk

Næste emne: fuzzing og invarianttest.

Gratis at komme i gang

Lær Grundlæggende udvikling af Web3- og DApp-programmer med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser
29
Lektioner
105

Ofte stillede spørgsmål

Er lektionen “forge-test” gratis?

Ja — alle 3 lektioner i læringssporet Grundlæggende udvikling af Web3- og DApp-programmer, inklusive “forge-test”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Grundlæggende udvikling af Web3- og DApp-programmer-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “forge-test”?

Solidity-tests Du øver dig i Grundlæggende udvikling af Web3- og DApp-programmer med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på Grundlæggende udvikling af Web3- og DApp-programmer?

Der kræves ingen tidligere erfaring. Grundlæggende udvikling af Web3- og DApp-programmer på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 2 af 4.

Hvor lang tid tager lektionen “forge-test”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne Grundlæggende udvikling af Web3- og DApp-programmer-lektion?

Ja. Alle Grundlæggende udvikling af Web3- og DApp-programmer-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

  1. Foundry kontra Hardhat
  2. forge-test
  3. Fuzzing og invariants
  4. cast og anvil
← Tilbage til Grundlæggende udvikling af Web3- og DApp-programmer