[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M786DQ9FDGFMJTF6WANNJ7QG":3,"skill-same:01M786DQ9FDGFMJTF6WANNJ7QG":47},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M786DQ9FDGFMJTF6WANNJ7QG","ts-testing",null,"allanpablo\u002Fforja","allanpablo","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22358346?v=4","01M786AH79M6N27CC4HZ2AHJTQ","Allan Pablo","01M786AH80CPCTFFMSTRMGEGYF",2,"MIT","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-testing\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: ts-testing\ndescription: Use quando escrever ou revisar código de teste em TypeScript ou JavaScript: casos parametrizados, o executor do projeto (Vitest, node:test, Jest), fakes escritos à mão, timers falsos e relógios injetados, asserções de erro, isolamento de HTTP e rede, testes baseados em propriedades, testes de tipos e isolamento dos testes de integração. Funciona em par com a skill `testing`, que decide o que testar.\n---\n\n# Testes em TypeScript\n\nIdiomas de TypeScript para código de teste. A skill `testing` decide **o que** testar e em qual camada; esta decide **como** isso é escrito em TypeScript ou JavaScript. Use as duas juntas: planeje com `testing`, escreva com `ts-testing`.\n\nAs convenções existentes no código prevalecem sobre esta skill.\n\n## Convenções\n\n- Use o executor que o projeto já tem. Quando não houver nenhum: Vitest para projetos TypeScript, `node:test` para pacotes Node pequenos que querem zero dependências. Não adicione Jest a um projeto que tem Vitest, nem o contrário.\n- Nenhuma biblioteca de asserção, mock ou matcher além do que o executor oferece, a menos que o projeto já a use.\n- Testes unitários junto do código (`order.test.ts`); testes de integração e e2e em `test\u002F`, com config ou padrão de nome próprios.\n- Os testes passam pela checagem de tipos como o resto do código (`tsc --noEmit` os cobre). Um teste que só passa porque o executor remove os tipos não está passando.\n\n## Comandos\n\n- Gate do CI: a suíte inteira mais a checagem de tipos, por exemplo `tsc --noEmit && vitest run` ou `node --test`.\n- Localmente, rode só o que você está mexendo: `vitest run src\u002Fbooking`, `vitest -t \"\u003Cnome do caso>\"`, `node --test --test-name-pattern \"\u003Cnome>\"`.\n- A suíte rápida e a suíte de integração são comandos separados (`test` e `test:e2e`\u002F`test:integration`).\n\n## Estrutura\n\n- **Casos parametrizados**: `it.each` \u002F `test.each` com um array de objetos nomeados, ou um `for … of` sobre os casos chamando `test(nome, …)`. Uma tabela por comportamento, não por função. Nomes dos casos na linguagem ubíqua.\n- `describe` agrupa um comportamento; nada de aninhamento profundo.\n- Caixa-preta por padrão: importe a API pública do módulo. Não exporte internos só para os testes alcançarem.\n- Cada teste monta os próprios dados; `beforeEach` só para preparação que todos os casos de fato compartilham. Nenhum estado vazando entre testes.\n\n```ts\ndescribe('Period.contains', () => {\n  const period = mustPeriod(start, end); \u002F\u002F helper de teste: cria um Period válido ou falha o teste\n\n  it.each([\n    { name: 'no início', at: start, want: true },\n    { name: 'no fim', at: end, want: true },\n    { name: 'um milissegundo depois do fim', at: new Date(end.getTime() + 1), want: false },\n  ])('$name', ({ at, want }) => {\n    expect(period.contains(at)).toBe(want);\n  });\n});\n```\n\n## Dependências\n\n- **Fakes**: classes em memória escritas à mão implementando a interface do repositório (`class InMemoryBookingRepository implements BookingRepository`). Com tipagem estrutural, um objeto simples também serve; mantenha-o tipado.\n- **Mocks**: `vi.fn()` \u002F `mock.fn()` só para observar uma chamada que é o próprio comportamento (um evento publicado, um e-mail enviado). Não para substituir por padrão os colaboradores do sistema sob teste.\n- **Mock de módulo** (`vi.mock`, `jest.mock`) é último recurso: acopla o teste a caminhos de arquivo e esconde costuras que faltam. Prefira passar a dependência.\n- **Tempo**: o código de domínio recebe o tempo como parâmetro ou um relógio injetado (`() => Date`); nunca `new Date()` ou `Date.now()` dentro do domínio. Para código com timers, use timers falsos (`vi.useFakeTimers()`, `mock.timers.enable()` no `node:test`) e avance-os explicitamente. O mesmo vale para IDs e aleatoriedade.\n- **Handlers HTTP**: a injeção em processo do framework (`app.inject()` no Fastify, `supertest` contra o app Nest\u002FExpress), não uma porta real.\n- **HTTP de saída**: intercepte na camada de rede (`msw`, ou o `MockAgent` do `undici` para o `fetch` embutido). Falhe o teste em qualquer requisição não prevista.\n- **Ambiente**: a configuração é passada; os testes nunca dependem do `.env` do desenvolvedor.\n\n## Erros e comparação\n\n- Verifique o tipo ou o código do erro: `await expect(promise).rejects.toBeInstanceOf(InvalidPeriodError)`, ou um campo `code`. Nunca o texto da mensagem.\n- Quando o código devolve resultados em vez de lançar (`Result`\u002F`Either`), verifique a variante de erro, não uma exceção lançada.\n- `toEqual` para comparar valores, `toStrictEqual` quando propriedades `undefined` e a identidade da classe importam. Use `expect.objectContaining` com parcimônia; asserções parciais escondem regressões.\n- Sempre faça `await` ou `return` das asserções sobre promises. Um `await` faltando num `rejects` faz o teste passar sem verificar nada.\n\n## Dados\n\n- Fixtures em `test\u002Ffixtures\u002F`; builders (`aBooking({ … })`) para objetos de domínio com padrões razoáveis.\n- Snapshots só para saídas grandes, estáveis e revisadas (documentos gerados, contratos serializados). Nunca para objetos que você poderia verificar campo a campo.\n- **Testes baseados em propriedades** (`fast-check`) para parsers e construtores de objetos de valor que aceitam entrada externa (CPF\u002FCNPJ, e-mails, documentos). Use os casos da tabela como semente.\n- **Testes de tipos** para tipos públicos de bibliotecas: `expectTypeOf` (Vitest) ou `tsd`, rodando no CI.\n\n## Testes de integração\n\n- Comando e config separados, para a suíte rápida continuar rápida.\n- Dependências reais (PostgreSQL num container via Testcontainers ou um serviço do compose). Cada teste é dono dos seus dados: uma transação revertida no fim, ou um schema\u002Fbanco dedicado.\n- Nenhum teste depende da ordem de execução de outro.\n\n## Benchmarks\n\n`vitest bench` (ou `node:test` com `performance.now()` num script dedicado) só quando desempenho é um requisito declarado. Benchmarks não rodam na suíte rápida.\n\n## Evite\n\n- Um segundo framework de teste ou biblioteca de asserção.\n- `new Date()`, `Math.random()`, `crypto.randomUUID()` ou estado global dentro do código sob teste.\n- Verificar o texto das mensagens de erro.\n- Esperas reais com `setTimeout` ou polling sem prazo.\n- `vi.mock` dos seus próprios módulos como forma padrão de isolar.\n- `expect(...).rejects` \u002F `resolves` sem `await`.\n- `any` nos testes para calar a checagem de tipos.\n- Exportar identificadores só para os testes alcançarem.\n","# Testes em TypeScript\n\nIdiomas de TypeScript para código de teste. A skill `testing` decide **o que** testar e em qual camada; esta decide **como** isso é escrito em TypeScript ou JavaScript. Use as duas juntas: planeje com `testing`, escreva com `ts-testing`.\n\nAs convenções existentes no código prevalecem sobre esta skill.\n\n## Convenções\n\n- Use o executor que o projeto já tem. Quando não houver nenhum: Vitest para projetos TypeScript, `node:test` para pacotes Node pequenos que querem zero dependências. Não adicione Jest a um projeto que tem Vitest, nem o contrário.\n- Nenhuma biblioteca de asserção, mock ou matcher além do que o executor oferece, a menos que o projeto já a use.\n- Testes unitários junto do código (`order.test.ts`); testes de integração e e2e em `test\u002F`, com config ou padrão de nome próprios.\n- Os testes passam pela checagem de tipos como o resto do código (`tsc --noEmit` os cobre). Um teste que só passa porque o executor remove os tipos não está passando.\n\n## Comandos\n\n- Gate do CI: a suíte inteira mais a checagem de tipos, por exemplo `tsc --noEmit && vitest run` ou `node --test`.\n- Localmente, rode só o que você está mexendo: `vitest run src\u002Fbooking`, `vitest -t \"\u003Cnome do caso>\"`, `node --test --test-name-pattern \"\u003Cnome>\"`.\n- A suíte rápida e a suíte de integração são comandos separados (`test` e `test:e2e`\u002F`test:integration`).\n\n## Estrutura\n\n- **Casos parametrizados**: `it.each` \u002F `test.each` com um array de objetos nomeados, ou um `for … of` sobre os casos chamando `test(nome, …)`. Uma tabela por comportamento, não por função. Nomes dos casos na linguagem ubíqua.\n- `describe` agrupa um comportamento; nada de aninhamento profundo.\n- Caixa-preta por padrão: importe a API pública do módulo. Não exporte internos só para os testes alcançarem.\n- Cada teste monta os próprios dados; `beforeEach` só para preparação que todos os casos de fato compartilham. Nenhum estado vazando entre testes.\n\n```ts\ndescribe('Period.contains', () => {\n  const period = mustPeriod(start, end); \u002F\u002F helper de teste: cria um Period válido ou falha o teste\n\n  it.each([\n    { name: 'no início', at: start, want: true },\n    { name: 'no fim', at: end, want: true },\n    { name: 'um milissegundo depois do fim', at: new Date(end.getTime() + 1), want: false },\n  ])('$name', ({ at, want }) => {\n    expect(period.contains(at)).toBe(want);\n  });\n});\n```\n\n## Dependências\n\n- **Fakes**: classes em memória escritas à mão implementando a interface do repositório (`class InMemoryBookingRepository implements BookingRepository`). Com tipagem estrutural, um objeto simples também serve; mantenha-o tipado.\n- **Mocks**: `vi.fn()` \u002F `mock.fn()` só para observar uma chamada que é o próprio comportamento (um evento publicado, um e-mail enviado). Não para substituir por padrão os colaboradores do sistema sob teste.\n- **Mock de módulo** (`vi.mock`, `jest.mock`) é último recurso: acopla o teste a caminhos de arquivo e esconde costuras que faltam. Prefira passar a dependência.\n- **Tempo**: o código de domínio recebe o tempo como parâmetro ou um relógio injetado (`() => Date`); nunca `new Date()` ou `Date.now()` dentro do domínio. Para código com timers, use timers falsos (`vi.useFakeTimers()`, `mock.timers.enable()` no `node:test`) e avance-os explicitamente. O mesmo vale para IDs e aleatoriedade.\n- **Handlers HTTP**: a injeção em processo do framework (`app.inject()` no Fastify, `supertest` contra o app Nest\u002FExpress), não uma porta real.\n- **HTTP de saída**: intercepte na camada de rede (`msw`, ou o `MockAgent` do `undici` para o `fetch` embutido). Falhe o teste em qualquer requisição não prevista.\n- **Ambiente**: a configuração é passada; os testes nunca dependem do `.env` do desenvolvedor.\n\n## Erros e comparação\n\n- Verifique o tipo ou o código do erro: `await expect(promise).rejects.toBeInstanceOf(InvalidPeriodError)`, ou um campo `code`. Nunca o texto da mensagem.\n- Quando o código devolve resultados em vez de lançar (`Result`\u002F`Either`), verifique a variante de erro, não uma exceção lançada.\n- `toEqual` para comparar valores, `toStrictEqual` quando propriedades `undefined` e a identidade da classe importam. Use `expect.objectContaining` com parcimônia; asserções parciais escondem regressões.\n- Sempre faça `await` ou `return` das asserções sobre promises. Um `await` faltando num `rejects` faz o teste passar sem verificar nada.\n\n## Dados\n\n- Fixtures em `test\u002Ffixtures\u002F`; builders (`aBooking({ … })`) para objetos de domínio com padrões razoáveis.\n- Snapshots só para saídas grandes, estáveis e revisadas (documentos gerados, contratos serializados). Nunca para objetos que você poderia verificar campo a campo.\n- **Testes baseados em propriedades** (`fast-check`) para parsers e construtores de objetos de valor que aceitam entrada externa (CPF\u002FCNPJ, e-mails, documentos). Use os casos da tabela como semente.\n- **Testes de tipos** para tipos públicos de bibliotecas: `expectTypeOf` (Vitest) ou `tsd`, rodando no CI.\n\n## Testes de integração\n\n- Comando e config separados, para a suíte rápida continuar rápida.\n- Dependências reais (PostgreSQL num container via Testcontainers ou um serviço do compose). Cada teste é dono dos seus dados: uma transação revertida no fim, ou um schema\u002Fbanco dedicado.\n- Nenhum teste depende da ordem de execução de outro.\n\n## Benchmarks\n\n`vitest bench` (ou `node:test` com `performance.now()` num script dedicado) só quando desempenho é um requisito declarado. Benchmarks não rodam na suíte rápida.\n\n## Evite\n\n- Um segundo framework de teste ou biblioteca de asserção.\n- `new Date()`, `Math.random()`, `crypto.randomUUID()` ou estado global dentro do código sob teste.\n- Verificar o texto das mensagens de erro.\n- Esperas reais com `setTimeout` ou polling sem prazo.\n- `vi.mock` dos seus próprios módulos como forma padrão de isolar.\n- `expect(...).rejects` \u002F `resolves` sem `await`.\n- `any` nos testes para calar a checagem de tipos.\n- Exportar identificadores só para os testes alcançarem.\n",{},"main","cfe29d604e93a4c19fd25db4289328f6ec17bb41","templates\u002Fproject\u002Fskills\u002Fts-testing",0,"https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja","npmjs.com\u002Fforjajs","https:\u002F\u002Fgithub.com\u002Fallanpablo","www.allanpablo.com.br","Gestor de TI","2026-11-15 05:12:58",{"source":7,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add allanpablo\u002Fforja --skill ts-testing",{"tool":39,"command":40},"bunx","bunx skills add allanpablo\u002Fforja --skill ts-testing",{"tool":42,"command":43},"pnpm","pnpm dlx skills add allanpablo\u002Fforja --skill ts-testing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-testing\u002FSKILL.md",true,[],[48,54,60,66,72,78],{"skillNo":49,"name":50,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":18},"01M786DTCHHV8K0MZMQQA2N81Q","web-performance","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fweb-performance\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":18},"01M786DMASM9PXP0NSEZYTHA7Q","ts-module-layout","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-module-layout\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":18},"01M786DH4Y3AD551JN35D2R3HY","ts-code-review","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-code-review\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M786DF1R7PCK6KB44B34110S","ts-async-patterns","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-async-patterns\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":18},"01M786DDCF8GHQ8KY2X4DGY3XN","threat-modeling","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fthreat-modeling\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":18},"01M786DBDE38J5471FBVFB1DV8","testing","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Ftesting\u002FSKILL.md",[],[]]