Web3 & DApp Development Fundamentals · درس

التركيبات

إعداد اختبار قابل لإعادة الاستخدام

التركيبات درس مجاني في Web3 & DApp Development Fundamentals على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Web3 & DApp Development Fundamentals، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Web3 & DApp Development Fundamentals 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

The Setup Problem

Many tests need the same starting state — a deployed contract, funded accounts, initial config. Repeating this setup in every beforeEach is slow and repetitive.

Fixtures solve this by running setup once and snapshotting the result.

What Is loadFixture

Hardhat provides loadFixture in its network helpers. The first time it runs a fixture function and takes an EVM snapshot. Later calls simply revert to that snapshot instead of re-running everything.

This makes tests both fast and perfectly isolated.

Importing the Helper

Import loadFixture from the network helpers package (included in the Toolbox):

const {
  loadFixture,
} = require("@nomicfoundation/hardhat-network-helpers");
const { expect } = require("chai");
const { ethers } = require("hardhat");

const {
  loadFixture,
} = require("@nomicfoundation/hardhat-network-helpers");
const { expect } = require("chai");
const { ethers } = require("hardhat");

Writing a Fixture Function

A fixture is an async function that performs setup and returns the objects tests need:

async function deployTokenFixture() {
  const [owner, alice] = await ethers.getSigners();
  const Token = await ethers.getContractFactory("Token");
  const token = await Token.deploy();
  return { token, owner, alice };
}

async function deployTokenFixture() {
  const [owner, alice] = await ethers.getSigners();
  const Token = await ethers.getContractFactory("Token");
  const token = await Token.deploy();
  return { token, owner, alice };
}

Using a Fixture in a Test

Call loadFixture at the start of each test and destructure what you need:

it("assigns supply to owner", async function () {
  const { token, owner } = await loadFixture(deployTokenFixture);
  expect(await token.balanceOf(owner.address))
    .to.equal(await token.totalSupply());
});

it("assigns supply to owner", async function () {
  const { token, owner } = await loadFixture(deployTokenFixture);
  expect(await token.balanceOf(owner.address))
    .to.equal(await token.totalSupply());
});

Why Fixtures Are Fast

Re-running deployment for every test is expensive. With fixtures:

The setup transactions execute only once.
Subsequent tests revert the EVM to the snapshot — a near-instant operation.

Large suites can run dramatically faster than equivalent beforeEach setups.

Isolation Guarantee

Because each loadFixture call reverts to the original snapshot, tests cannot leak state into each other. One test transferring tokens does not affect the next test's starting balances.

This isolation is what makes test results reliable and order-independent.

Fixtures with Parameters

loadFixture takes a function reference, not a call, so it cannot accept arguments directly. To vary setup, define multiple fixtures:

async function deployPausedFixture() {
  const base = await deployTokenFixture();
  await base.token.pause();
  return base;
}

Each variant gets its own snapshot.

async function deployPausedFixture() {
  const base = await deployTokenFixture();
  await base.token.pause();
  return base;
}

Fixtures vs beforeEach

When should you use each?

loadFixture — preferred for deployment-heavy setup; faster and snapshot-based.
beforeEach — fine for trivial setup or when you need per-test side effects.

The Hardhat team recommends fixtures for most contract deployment setup.

A Common Pitfall

Do not call the fixture function directly inside loadFixture:

// Wrong: passes the result, not the function
await loadFixture(deployTokenFixture());

// Right: passes the function reference
await loadFixture(deployTokenFixture);

Passing the reference lets Hardhat manage the snapshot lifecycle.

// Wrong: passes the result, not the function
await loadFixture(deployTokenFixture());

// Right: passes the function reference
await loadFixture(deployTokenFixture);

Sharing Fixtures Across Files

You can move a fixture into its own module and import it wherever needed:

// fixtures.js
module.exports = { deployTokenFixture };

// in a test file
const { deployTokenFixture } = require("./fixtures");
const { token } = await loadFixture(deployTokenFixture);

The snapshot caching still works across files in the same run.

// fixtures.js
module.exports = { deployTokenFixture };

// in a test file
const { deployTokenFixture } = require("./fixtures");
const { token } = await loadFixture(deployTokenFixture);

Quick Check

Test your understanding of fixtures.

Recap

You learned reusable test setup with fixtures.

loadFixture runs setup once and snapshots the EVM.
Later calls revert to the snapshot — fast and fully isolated.
A fixture is an async function returning the objects tests need.
Pass the function reference, never call it.
Define multiple fixtures for different starting states.

الأسئلة الشائعة

هل درس «التركيبات» مجاني؟

نعم — نص درس «التركيبات» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Web3 & DApp Development Fundamentals، انتقل إلى CoddyKit PRO. تتضمن دورة Web3 & DApp Development Fundamentals 4 دروس في المجموع.

ماذا ستتعلم في «التركيبات»؟

إعداد اختبار قابل لإعادة الاستخدام تتمرن على Web3 & DApp Development Fundamentals مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Web3 & DApp Development Fundamentals؟

لا تُشترط خبرة سابقة. Web3 & DApp Development Fundamentals على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.

كم من الوقت يستغرق درس «التركيبات»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Web3 & DApp Development Fundamentals هذا؟

نعم. كل درس في Web3 & DApp Development Fundamentals يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى Web3 & DApp Development Fundamentals