# Gerar testes de unidade

Crie testes de unidade focados para seu código.

> \[!NOTE]
> \*
> Copilot os arquivos de prompt estão em prévia pública e estão sujeitos a alterações.
> Os arquivos de prompt só estão disponíveis em VS Code, Visual Studio e IDEs JetBrains. Consulte [Sobre a personalização das respostas do GitHub Copilot](/pt/copilot/concepts/prompting/response-customization#about-prompt-files).
>
> * Para obter exemplos de arquivos de prompt com contribuição da comunidade para idiomas e cenários específicos, consulte o site [personalizações incríveisGitHub Copilot](https://awesome-copilot.github.com).

Esse arquivo de prompt gera testes de unidade focados para funções ou métodos específicos, enfatizando casos de teste práticos e código que pode receber manutenção.

## Prompt de geração de teste de unidade

```text copy
---
agent: 'agent'
description: 'Generate unit tests for selected functions or methods'
---

## Task

Analyze the selected function/method and generate focused unit tests that thoroughly validate its behavior.

## Test Generation Strategy

1. **Core Functionality Tests**
   - Test the main purpose/expected behavior
   - Verify return values with typical inputs
   - Test with realistic data scenarios

2. **Input Validation Tests**
   - Test with invalid input types
   - Test with null/undefined values
   - Test with empty strings/arrays/objects
   - Test boundary values (min/max, zero, negative numbers)

3. **Error Handling Tests**
   - Test expected exceptions are thrown
   - Verify error messages are meaningful
   - Test graceful handling of edge cases

4. **Side Effects Tests** (if applicable)
   - Verify external calls are made correctly
   - Test state changes
   - Validate interactions with dependencies

## Test Structure Requirements

- Use existing project testing framework and patterns
- Follow AAA pattern: Arrange, Act, Assert
- Write descriptive test names that explain the scenario
- Group related tests in describe/context blocks
- Mock external dependencies cleanly

Target function: ${input:function_name:Which function or method should be tested?}
Testing framework: ${input:framework:Which framework? (jest/vitest/mocha/pytest/rspec/etc)}

## Guidelines

- Generate 5-8 focused test cases covering the most important scenarios
- Include realistic test data, not just simple examples
- Add comments for complex test setup or assertions
- Ensure tests are independent and can run in any order
- Focus on testing behavior, not implementation details

Create tests that give confidence the function works correctly and help catch regressions.
```

## Como usar este arquivo de prompt

1. Salve o conteúdo acima como `generate-unit-tests.prompt.md` na pasta `.github/prompts`.
2. Abra o arquivo de código que contém as funções para as quais você deseja criar testes. Opcionalmente, você pode realçar uma função específica.
3. No Visual Studio Code, abra a exibição do Bate-papo do Copilot e insira `/generate-unit-tests`. Outra alternativa é especificar a função de destino e a estrutura de teste digitando `function_name=fetchActivities` e `framework=pytest`, por exemplo.

## Leitura adicional

* [Usar arquivos de prompt em Visual Studio Code](https://code.visualstudio.com/docs/copilot/customization/prompt-files)Visual Studio Code na documentação – Informações sobre como criar e usar arquivos de prompt
* [Sobre a personalização das respostas do GitHub Copilot](/pt/copilot/concepts/prompting/response-customization) – Visão geral da personalização de resposta no GitHub Copilot
* [Personalizações incríveis do GitHub Copilot](https://github.com/github/awesome-copilot/blob/main/docs/README.prompts.md) – repositório de arquivos de prompt personalizados com a contribuição da comunidade e outras personalizações para linguagens e cenários específicos