Partilhar via

Afirmações do MSTest

Use as classes do namespace para verificar a AssertMicrosoft.VisualStudio.TestTools.UnitTesting funcionalidade específica. Um método de teste exercita o código na sua aplicação, mas só reporta a correção quando inclui declarações Assert.

Visão geral

O MSTest fornece três classes de asserção:

Class Propósito
Assert Afirmações de propósito geral para valores, tipos e exceções.
StringAssert Asserções específicas de cadeias de caracteres para padrões, substrings e comparações.
CollectionAssert Afirmações de coleção para comparar e validar coleções.

Sugestão

Quando existe funcionalidade em ambos Assert e StringAssert/CollectionAssert, prefira a classe Assert. A Assert classe oferece melhor descoberta e é a escolha recomendada para código novo. StringAssert e CollectionAssert são mantidos para compatibilidade retroativa.

Todos os métodos de asserção aceitam um parâmetro de mensagem opcional que aparece quando a asserção falha, ajudando a identificar a causa:

Assert.AreEqual(expected, actual, "Values should match after processing");

A Assert classe

Use a classe Assert para verificar se o código em teste se comporta conforme o esperado.

Métodos comuns de asserção

[TestMethod]
public async Task AssertExamples()
{
    // Equality
    Assert.AreEqual(5, calculator.Add(2, 3));
    Assert.AreNotEqual(0, result);

    // Reference equality
    Assert.AreSame(expected, actual);
    Assert.AreNotSame(obj1, obj2);

    // Boolean conditions
    Assert.IsTrue(result > 0);
    Assert.IsFalse(string.IsNullOrEmpty(name));

    // Null checks
    Assert.IsNull(optionalValue);
    Assert.IsNotNull(requiredValue);

    // Type checks
    Assert.IsInstanceOfType<IDisposable>(obj);
    Assert.IsNotInstanceOfType<string>(obj);

    // Exception testing (MSTest v3.8+)
    Assert.ThrowsExactly<ArgumentNullException>(() => service.Process(null!));
    await Assert.ThrowsExactlyAsync<InvalidOperationException>(
        async () => await service.ProcessAsync());
}

APIs disponíveis

A StringAssert classe

Use a StringAssert classe para comparar e examinar cadeias de caracteres.

Observação

Todos os StringAssert métodos têm equivalentes na Assert disciplina. Prefira os métodos Assert para uma melhor capacidade de descoberta. A StringAssert classe é mantida para compatibilidade retroativa.

As APIs disponíveis são:

A CollectionAssert classe

Use a CollectionAssert classe para comparar coleções de objetos ou para verificar o estado de uma coleção.

Observação

Quando existe um método equivalente na Assert classe (como Assert.Contains, Assert.DoesNotContain), prefere usar Assert para melhor descoberta. A CollectionAssert classe é mantida principalmente para compatibilidade retroativa.

As APIs disponíveis são:

Melhores práticas

  1. Use afirmações específicas: Prefira AreEqual em vez de IsTrue(a == b) para obter melhores mensagens de falha.

  2. Inclua mensagens descritivas: Ajude a identificar falhas rapidamente com mensagens claras de afirmação.

  3. Teste uma coisa de cada vez: Cada método de teste deve verificar um único comportamento.

  4. Utilização Throws/ThrowsExactly para exceções: No MSTest v3.8+, preferem Assert.Throws, Assert.ThrowsExactly, e os seus equivalentes assíncronos (ThrowsAsync, ThrowsExactlyAsync) em vez do ExpectedException atributo.

  5. Preferir Assert em vez de StringAssert/CollectionAssert: Quando existe funcionalidade em ambas as classes, use a classe Assert para melhor visibilidade e consistência.

Os seguintes analisadores ajudam a garantir a utilização correta das asserções:

  • MSTEST0006 - Evita ExpectedException atributos, usa Assert.Throws métodos em vez disso.
  • MSTEST0017 - Os argumentos de afirmação devem ser apresentados na ordem correta.
  • MSTEST0023 - Não negues afirmações booleanas.
  • MSTEST0025 - Prefere Assert.Fail a condições sempre falsas.
  • MSTEST0026 - Os argumentos de asserção devem evitar o acesso condicional.
  • MSTEST0032 - Revisar condições de asserção sempre verdadeiras.
  • MSTEST0037 - Use métodos adequados de afirmação.
  • MSTEST0038 - Evite Assert.AreSame com os tipos de valor.
  • MSTEST0039 - Use métodos mais Assert.Throws recentes.
  • MSTEST0040 - Evite usar assertos em contexto void assíncrono.
  • MSTEST0046 - Use Assert em vez de StringAssert.
  • MSTEST0051 - Assert.Throws deve conter uma única instrução.
  • MSTEST0053 - Evite Assert parâmetros de formato.
  • MSTEST0058 - Evite assertivas em blocos catch.

Consulte também

  • Last updated on