Timeout

Definição

Timeout delimita quanto tempo o cliente aguarda pela conclusão de uma operação. A espera começa quando a chamada parte, e o limite encerra a espera quando o tempo escolhido é atingido. O timeout impede que uma chamada travada ocupe o fluxo por tempo indeterminado.

Início, limite e resultado

O cliente acompanha o início da espera e o instante no qual o limite é atingido. Sem resposta dentro do tempo, o resultado é desconhecido, e o fluxo precisa definir o tratamento dessa situação. Desconhecido não significa falho nem concluído, e cada uma dessas leituras leva a um próximo passo diferente.

O que o timeout não comprova

O timeout não prova que o servidor deixou de executar a operação. O efeito pode ter ocorrido depois do encerramento da espera, e o fluxo precisa considerar essa possibilidade antes de repetir ou encerrar a operação. Repetir sem conferir pode criar um segundo efeito sobre um resultado que já existia.

Resultado desconhecido e verificação

A falha comum é repetir a chamada logo após o timeout sem consultar o estado da operação: se o efeito já ocorreu no servidor, a repetição cria uma duplicação. Para verificar, consulte o estado da operação no destino antes de decidir o próximo passo. Quando a consulta confirma que o efeito aconteceu, o resultado deixa de ser desconhecido, e a comparação entre o horário do timeout e o estado atual mostra se a pendência foi concluída no servidor.

Aplicação na formação

n8n Experts

Na formação n8n Experts, timeout delimita a espera de uma etapa e orienta o tratamento de resultados desconhecidos.

Conhecer a formação →