Testes Baseados em Propriedades com StreamData
Vá além dos testes baseados em exemplos gerando centenas de entradas aleatórias com StreamData para encontrar casos-limite que os exemplos ExUnit não detetam.
Testes Baseados em Propriedades com StreamData é uma aula grátis de Elixir & Phoenix: Scalable Backend Development no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Elixir & Phoenix: Scalable Backend Development, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Elixir & Phoenix: Scalable Backend Development inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
What is Property-Based Testing?
Traditional tests check specific examples. Property-based testing describes a rule that should hold for all inputs, then generates many random inputs to try to break it.
It excels at finding edge cases you never thought to write by hand.
Adding StreamData
StreamData is the Elixir library for generating test data. Add it to your dependencies.
defp deps do
[{:stream_data, "~> 0.6", only: :test}]
endImporting the Helpers
Use ExUnitProperties in your test module to unlock the check all and property macros.
defmodule MyApp.MathTest do
use ExUnit.Case
use ExUnitProperties
endWriting a Property
The property macro replaces test. Inside, check all draws values from a generator and runs the body for each.
property "reversing twice returns the original list" do
check all list <- list_of(integer()) do
assert Enum.reverse(Enum.reverse(list)) == list
end
endBuilt-in Generators
StreamData provides generators for common types:
integer(),float(),boolean()string(:alphanumeric)list_of/1,map_of/2
check all name <- string(:alphanumeric), age <- integer(0..120) do
assert build_user(name, age).age >= 0
endCombining Generators
Use tuple/1 or bind multiple generators in one check all to produce structured data.
check all {a, b} <- tuple({integer(), integer()}) do
assert a + b == b + a
endTransforming with map
StreamData.map/2 reshapes generated values, e.g. building positive integers from any integer.
positive = StreamData.map(integer(), &abs/1)
check all n <- positive do
assert n >= 0
endFiltering Inputs
filter/2 discards values that do not match a condition. Use it sparingly — heavy filtering slows generation.
non_zero = StreamData.filter(integer(), &(&1 != 0))
check all d <- non_zero do
assert div(d, d) == 1
endShrinking Failures
When a property fails, StreamData shrinks the input — repeatedly simplifying it — to report the smallest failing example. This makes debugging far easier than a random huge value.
Choosing Good Properties
Effective properties describe invariants rather than restating the implementation:
- Round-trip: encode then decode returns the original
- Idempotency: applying twice equals applying once
- Invariants: a sorted list is always ordered
When to Use It
Property tests complement, not replace, example tests. Reach for them on pure functions, parsers, serializers, and data transformations where many inputs share one rule.
Quick Check
Test your property-based testing knowledge.
Recap
You learned property-based testing with StreamData:
- Describe rules that hold for all inputs
- Use
property+check allwith generators - Combine, map, and filter generators
- Shrinking reports the minimal failing case
- Best for invariants, round-trips, and idempotency
It uncovers edge cases example tests miss.
Perguntas Frequentes
A aula “Testes Baseados em Propriedades com StreamData” é grátis?
Sim — o texto completo de “Testes Baseados em Propriedades com StreamData” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Elixir & Phoenix: Scalable Backend Development, atualize para CoddyKit PRO. O curso de Elixir & Phoenix: Scalable Backend Development inclui 4 aulas no total.
O que vou aprender em “Testes Baseados em Propriedades com StreamData”?
Vá além dos testes baseados em exemplos gerando centenas de entradas aleatórias com StreamData para encontrar casos-limite que os exemplos ExUnit não detetam. Você pratica Elixir & Phoenix: Scalable Backend Development com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Elixir & Phoenix: Scalable Backend Development?
Nenhuma experiência prévia é necessária. Elixir & Phoenix: Scalable Backend Development no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.
Quanto tempo leva a aula “Testes Baseados em Propriedades com StreamData”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Elixir & Phoenix: Scalable Backend Development?
Sim. Cada aula de Elixir & Phoenix: Scalable Backend Development inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Testes Unitários com ExUnit
- Testes de Integração de Aplicações Phoenix
- Mocks, Stubs e Dados de Teste
- Testes Baseados em Propriedades com StreamData