describe and it
- Node.js course
- Intermediate
- Lesson 84/116
- 5 min
Learn test organization with describe and it.
Grouping with describe
As tests multiply, grouping them with describe improves readability. describe("calculator", () => { test("add", ...); test("subtract", ...); }). describe takes a name and a callback; tests inside the callback form a group.
it is an alias for test. They mean the same; some teams prefer test, others it. Example: describe("math", () => { it("add", () => {}); }). Groups can be nested: a describe inside another describe. This breaks large test files into sections. In the output the group name prefixes the test name, so you quickly locate a failing test.
Nested groups
You can define a describe inside another describe. This is useful to break large features into sub-features. Example: describe("math", () => { describe("addition", () => { it("positive", () => {}); }); }).
The output shows the group hierarchy: math > addition > positive. This quickly shows which feature set a failing test belongs to. describe is only a visual grouping; at runtime tests still run in order. Tests inside a group can share a setup; we will do that with hooks in the next lesson. For now building the group structure is enough.
Practice Group calculator tests
Import test, describe and it from node:test. Group two tests with describe("calculator", () => { it("add", () => {}); it("subtract", () => {}); }). Print "Grouped" with console.log.
Starter code
// Import test, describe and it
// write here
// Group two tests with describe
// write here
// Print "Grouped"
// write hereSample solution
const { test, describe, it } = require("node:test");
describe("calculator", () => {
it("add", () => {});
it("subtract", () => {});
});
console.log("Grouped");Expected output
Gruplandı
Questions and answers
Review the lesson questions together with their answers. To test yourself, solve the lesson interactively.
1 Match each piece to its role
| Term | Meaning |
|---|---|
describe |
Defines a test group |
it |
Alias for test |
test |
Defines a single test |
() => {} |
Arrow function body |
2 What is the relationship between it and test?
test("x", () => {}); // it("x", () => {})- it runs faster
- test checks more strictly
- it is another name for test Correct answer
- test only works inside describe
Explanation: it is a synonym for test.
3 Complete the describe call
describe("hesap", ____ () => { it("topla", () => {}); });describe("hesap", () => () => { it("topla", () => {}); });Explanation: describe takes a name and an arrow function.