O Objeto Jest · Jest
O objeto jest é automaticamente inserido no escopo de cada arquivo de teste. Os métodos no objeto jest ajudam a criar simulações (mock, em inglês) e deixam você controlar o comportamento geral de Jest.
jest.runTimersToTime(msToRun)
Retorna uma nova, não utilizada função de simulação. Opcionalmente, toma uma implementação de simulação (mock, em inglês).
Simula um módulo com uma versão auto simulada quando ele está sendo "required". factory e options são opcionais. Por exemplo:
const moduleName = require('../moduleName'); // This runs the function specified as second argument to `jest.mock`.
* Implementação personalizada de um módulo que não existe em JS,
* como um módulo gerado ou um módulo nativo do react-native.
}, {virtual: true});
Aviso: Importar um módulo em um arquivo de instalação (conforme especificado pelo setupTestFrameworkScriptFile) impedirá a simulação para o módulo em questão, bem como todos os módulos que ele importa.
Módulos que são simulados (mocked, em inglês) com jest.mock são simulados apenas para o arquivo que chama jest.mock. Outro arquivo que importa o módulo receberá a implementação original, mesmo se executado após o arquivo de teste que simula o módulo.
Ao usar babel-jest, chamadas para mock serão automaticamente içadas (hoisted, em inglês) até o topo do bloco de código. Use este método se você deseja evitar explicitamente esse comportamento.
Ao usar babel-jest, chamadas para unmock serão automaticamente içadas (hoisted, em inglês) até o topo do bloco de código. Use este método se você deseja evitar explicitamente esse comportamento.
Limpa as propriedades mock.calls e mock.instances de todas as simulações. Equivalente a chamar .mockClear() em cada função de simulação.
Redefine o estado de todas as simulações. Equivalente a chamar .mockReset() em cada função simulada.
disponível no Jest 20.1.0+ #
Restaura todas as simulações (mocks, em inglês) para seu valor original. Equivalente a chamar .mockRestore em cada função simulada. Cuidado que jest.restoreAllMocks() só funciona quando a simulação foi criada com jest.spyOn; outras simulações vão exigir você restaurá-las manualmente.
Redefine o registro do módulo - o cache de todos os módulos necessários. Isso é útil para isolar módulos onde o estado local pode entrar em conflito entre os testes.
Esgota a fila de macro-task (ou seja, todas as tarefas enfileiradas por setTimeout(), setInterval() e setImmediate()).
Quando esta API é chamada, todas as "macro-tasks" pendentes que foram enfileiradas via setTimeout() ou setInterval() serão executadas. Adicionalmente, caso estas macro-tasks agendem novas macro-tasks, essas por sua vez serão esgotadas até que não haja mais macro-tasks na fila.
jest.runTimersToTime(msToRun) #
Quando esta API é chamada, todas as "macro-tasks" pendentes que foram enfileiradas via setTimeout() ou setInterval(), e que serão executadas dentro de msToRun milissegundos, serão executadas. Adicionalmente, caso estas macro-tarefas agendem novas macro-tarefas que seriam executadas dentro do mesmo prazo, aquelas serão executadas até que não haja mais nenhuma macro-tarefa restante na fila que deve ser executada dentro de msToRun milissegundos.
Cria uma função de simulação (mock, em inglês) semelhante ao jest.fn mas também rastreia chamadas para object[methodName]. Retorna uma função de simulação Jest.