Implementando Testes com Jest: Garantindo a Confiabilidade do Código

Por que escrever testes importa?

• Eles aumentam a confiabilidade do sistema.

• Tornam a manutenção mais fácil e menos arriscada.

• Permitem refatorações seguras sem a sensação de “andar no escuro”.

Por que escolhi testar com Jest?

• Resultados legíveis em múltiplos formatos, facilitando entender falhas rapidamente.

• Cache de resultados de testes, o que agiliza bastante quando a suíte cresce.

• Mocks e spies nativos, que simplificam o isolamento de dependências.

• Configuração mínima, funcionando bem desde o início sem precisar de muito setup.

Exemplo prático

// __tests__/get-post-list.spec.ts

// - usa @notionhq/client com um Client({ auth })
// - consulta data_source_id "collection-123"
// - aplica filtro { published: true } quando NODE_ENV === 'production'
// - ordena por updated_at desc
// - normaliza resultados, ignorando páginas no lixo, objetos que não são "page" e páginas sem props mínimas

import { Client } from '@notionhq/client'
import { getPostList } from '../src/services/get.posts.list'
import { createPage } from './fakes/page.ts'

// --- Mock da lib externa (@notionhq/client)
jest.mock('@notionhq/client', () => {
  const mockQuery = jest.fn()
  const MockClient = jest.fn().mockImplementation(() => ({
    dataSources: {
      query: mockQuery,
    },
  }))

  // expõe o mock para uso no teste
  ;(MockClient as any).__mockQuery = mockQuery
  return { Client: MockClient }
})

describe('get post list', () => {
  const mockQuery = (Client as any).__mockQuery as jest.Mock

  const OLD_ENV = process.env

  beforeEach(() => {
    jest.clearAllMocks()
    jest.useFakeTimers().setSystemTime(new Date('2025-01-01T12:00:00Z'))
    process.env = { ...OLD_ENV, NOTION_TOKEN: 'test-token' }
  })

  afterAll(() => {
    process.env = OLD_ENV
    jest.useRealTimers()
  })

  it('usa filtro published=true em produção', async () => {
    // força ambiente de produção para validar o filtro
    process.env.NODE_ENV = 'production'

    const results = [
      createPage({}), // válido
      createPage({ id: 'trash', in_trash: true }), // deve ser ignorado
      createPage({ id: 'not-page', object: 'database' }), // deve ser ignorado
      createPage({ id: 'missing-props', withProps: false }), // deve ser ignorado
      // outro válido, com props vazias que sua normalização trata:
      createPage({
        id: 'empty-props',
        slug: '',
        title: '',
        description: '',
        withProps: true,
      }),
    ]

    mockQuery.mockResolvedValueOnce({ results })

    const list = await getPostList()

    // 1) o Client foi instanciado com o token esperado
    expect(Client).toHaveBeenCalledWith({ auth: 'test-token' })

    // 2) a consulta foi feita com os parâmetros corretos em produção
    expect(mockQuery).toHaveBeenCalledWith({
      data_source_id: 'collection-123',
      filter: {
        property: 'published',
        checkbox: { equals: true },
      },
      sorts: [{ property: 'updated_at', direction: 'descending' }],
      page_size: 10,
    })

    // 3) a lista final contém apenas os itens válidos e normalizados
    expect(list).toHaveLength(2)

    expect(list[0]).toEqual({
      slug: 'my-slug',
      title: 'My Title',
      description: 'My Description',
      created_at: expect.any(Date),
      updated_at: expect.any(Date),
    })

    expect(list[1]).toEqual({
      slug: '',
      title: '',
      description: '',
      created_at: expect.any(Date),
      updated_at: expect.any(Date),
    })
  })
})

Evoluindo a mentalidade

Roadmap e próximos passos

• Expandir a implementação de testes automatizados para outras áreas do projeto.

• Melhorar o design para refletir um blog mais moderno e consistente.

• Adicionar scripts de monitoramento de performance do conteúdo.

• Utilizar uma ferramenta de bundle para otimizar o tamanho da aplicação dentro do monorepo.

• Refatorar o código para desacoplar módulos e preparar a aplicação para futuras substituições sem grandes impactos.

Conclusão