0Pricing
TypeScript Academy · Lekcja

Typowanie testów i mocków; expectTypeOf

Używanie expectTypeOf do statycznych sprawdzeń oraz bezpiecznych typowanych mocków w Vitest/Jest, aby zapobiegać kruchym testom

Typowanie testów i mocków; expectTypeOf to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 2 z 3. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej TypeScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs TypeScript Academy zawiera 3 lekcji w sumie.

Wprowadzenie

Cel: sprawdzać typy za pomocą expectTypeOf i pisać mocki bezpieczne typowo, aby refaktoryzacje nie psuły testów w sposób trudny do wykrycia.

Podstawy expectTypeOf

expectTypeOf sprawdza typy podczas kompilacji w Vitest. Nie obciąża działania programu, ale wcześnie wykrywa niezgodności.

// Vitest provides expectTypeOf
import { expectTypeOf } from "vitest";

function fullName(first: string, last: string) {
  return `${first} ${last}`
}

// static checks (compile-time)
expectTypeOf(fullName).toBeFunction()
expectTypeOf(fullName("Ada","Lovelace")).toBeString()

Zaawansowane asercje

Przydatne wzorce: uzyskiwanie typów zwracanych za pomocą Awaited<ReturnType<...>>, a także porównywanie literałów i unii.

import { expectTypeOf } from "vitest";

interface User { id: number; name: string }
function getUser(): Promise<User> { return Promise.resolve({ id:1, name:"A" }) }

// unwrap Promise
type Resolved = Awaited<ReturnType<typeof getUser>>
expectTypeOf<Resolved>().toMatchTypeOf<User>()

// literal + union
const status = "ok" as const
expectTypeOf(status).toEqualTypeOf<"ok">()

Mocki Vitest

Poprawnie określ typ mocka, podając sygnaturę dla vi.fn; nieprawidłowe argumenty zostaną wykryte podczas kompilacji.

import { vi, describe, it, expect } from "vitest";

function fetchUser(id: number): Promise<string> {
  return Promise.resolve(`user-${id}`)
}

// typed mock
const mockFetch: ReturnType<typeof vi.fn<[(id: number), Promise<string>]>> = vi.fn(async (id: number) => `user-${id}`)

it("uses typed mock", async () => {
  const name = await mockFetch(5)
  expect(name).toBe("user-5")
  // mockFetch("x") // TS error: id must be number
})

Mocki Jest

W Jest wymuś sygnaturę wywołania, zapisując jest.fn<Signature>(); doprecyzuj typ mocka za pomocą MockedFunction.

import { jest } from "@jest/globals";

function times(a: number, b: number) { return a * b }

const mul = jest.fn<(a:number,b:number)=>number>((a,b)=>a*b)

mul(2,3) // ok
// mul("2",3) // TS error

// MockedFunction utility
type MulMock = jest.MockedFunction<typeof mul>
const _check: MulMock = mul

Wskazówki

Oddziel walidację wartości (w czasie działania) od walidacji typów (podczas kompilacji); są to różne warstwy.

// value assertions
import { expect } from "vitest";
expect(2 + 3).toBe(5)

// type assertions (compile-time)
import { expectTypeOf } from "vitest";
expectTypeOf(2 + 3).toBeNumber()

// don't confuse with runtime validators like zod

Pytanie

Szybkie sprawdzenie: co sprawdza expectTypeOf podczas uruchamiania testu?

Podsumowanie

Podsumowanie: expectTypeOf — gwarancja typów podczas kompilacji; vi.fn/jest.fn — mocki bezpieczne typowo, zgodne z sygnaturą.

Często zadawane pytania

Czy lekcja „Typowanie testów i mocków; expectTypeOf” jest bezpłatna?

Tak — pełny tekst „Typowanie testów i mocków; expectTypeOf” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu TypeScript Academy, przejdź na CoddyKit PRO. Kurs TypeScript Academy zawiera 3 lekcji w sumie.

Co nauczysz się w „Typowanie testów i mocków; expectTypeOf”?

Używanie expectTypeOf do statycznych sprawdzeń oraz bezpiecznych typowanych mocków w Vitest/Jest, aby zapobiegać kruchym testom Ćwiczysz TypeScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć TypeScript Academy?

Nie wymagamy żadnego doświadczenia. TypeScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 3.

Ile czasu zajmuje lekcja „Typowanie testów i mocków; expectTypeOf”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji TypeScript Academy?

Tak. Każda lekcja TypeScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Konfiguracja Vitest/Jest dla TS
  2. Typowanie testów i mocków; expectTypeOf
  3. Wprowadzenie do typowania E2E (Playwright/Cypress)
← Powrót do TypeScript Academy