O Que É um Golden File?

Um golden file é uma cópia versionada da saída esperada de alguma operação, com a qual um teste compara a saída recém-produzida e falha em qualquer divergência. Ele captura saídas complexas ou grandes, código gerado, HTML renderizado, dados serializados, que seriam tediosas de verificar campo a campo. O golden file é atualizado deliberadamente quando uma mudança é intencional.

Por que isso importa

Para saídas grandes demais para escrever asserções à mão, um golden file é uma forma prática de fixar o comportamento e capturar mudanças não intencionais. A disciplina necessária é revisar os diffs ao atualizar o golden, já que regenerá-lo cegamente anula o propósito ao aceitar o que quer que o código produza agora.

Conceitos relacionados

• Também chamado de golden master ou approval testing
• Muito relacionado a snapshot tests
• Atualizá-lo exige revisar o diff, não regenerar cegamente

Guias relacionados