Skip to content

describe ​

Assinaturadescribe(name: string, callback: () => void): void

describe(name, callback) abre uma suíte e executa callback imediatamente, então os testes e hooks registrados dentro dele pertencem a essa suíte. Nenhum teste executa durante o registro: os testes executam depois que o programa registrou tudo, na ordem em que foram escritos, e uma suíte aninhada executa onde aparece.

O nome completo de um teste é o seu caminho pelas suítes, unido por >, como em discount > from 100 on > is ten percent.

Quando uma asserção falha durante o registro do callback de uma suíte, a suíte é reportada como falha e nenhum dos seus testes executa.

tyrus
import { describe, it, expect } from "tyrus:test";

const discount = (total: i32): i32 => {
    if (total >= 100) {
        return total / 10;
    }
    return 0;
};

describe("discount", () => {
    it("is zero below 100", () => {
        expect(discount(99)).toBe(0);
    });

    describe("from 100 on", () => {
        it("is ten percent", () => {
            expect(discount(250)).toBe(25);
        });
    });
});