Orientação gerada a partir de informações públicas. Apenas para referência.
O pacote async_queue garante que uma série de tarefas assíncronas seja executada sequencialmente, uma após a outra, mantendo a ordem e evitando problemas de concorrência. Ele fornece um mecanismo simples de fila para lidar com operações assíncronas de forma controlada, ideal para cenários em que a dependência entre tarefas ou a ordem de execução é crítica. Construído com Dart, integra-se perfeitamente em projetos Flutter em todas as principais plataformas. O pacote é leve e focado na confiabilidade, tornando-o adequado para processamento em segundo plano, sequenciamento de chamadas de API ou qualquer outro caso de uso que exija execução assíncrona ordenada.
Casos de uso
Chamadas de API sequenciais
Processamento de tarefas em segundo plano
Operações dependentes da ordem
Gerenciamento de estado com ações assíncronas
Carregando ativos em sequência
Principais recursos
Garante execução sequencial
Interface de fila simples
Suporte multiplataforma
Leve e dependências mínimas
Operação segura para threads
Indicado para
Desenvolvedores que precisam de execução assíncrona ordenada
Aplicativos com fluxos de trabalho assíncronos dependentes
Projetos que exigem agendamento de tarefas previsíveis
Aplicativos Flutter direcionados a múltiplas plataformas
Equipes que priorizam a simplicidade do código
Considerações
Não para execução de tarefas paralelas
Limitado a uma única fila por instância
Requer gerenciamento cuidadoso do ciclo de vida da fila
Mais adequado para lotes pequenos a médios de tarefas
Não trata lógica de repetição ou recuperação de erro
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
Async Queue - ensure your list of async tasks execute in order
This dart package ensures your pack of async tasks executes in order, one after the other.
What's new in v3.0.0
addJob returns a Future — await individual job results directly, no more listener workarounds
Automatic retry on exceptions — jobs that throw are retried up to retryTime without manual retry() calls
onError callback — handle errors at the queue level: AsyncQueue(onError: (error, label) { ... })
Priority queue — addJob(..., priority: 10) to run important jobs first
final asyncQ = AsyncQueue();
asyncQ.addQueueListener((event) => print("$event"));
Await job result (v3.0.0+)
addJob returns a Future that completes with the job's return value. This works alongside previousResult — they serve different purposes.
final q = AsyncQueue.autoStart();
// Each addJob returns a Future you can await for its resultfinal userFuture = q.addJob((_) async {
returnawait api.getUser(); // returns "Sam"
});
// previousResult still chains between jobsfinal postsFuture = q.addJob((previousResult) async {
returnawait api.getPostsFor(previousResult);
});
final user = await userFuture; // "Sam"final posts = await postsFuture; // [Post, Post, ...]
Automatic retry on exceptions (v3.0.0+)
Jobs that throw are automatically retried up to retryTime times. You no longer need to catch errors and call retry() manually (though you still can for custom logic).
q.addJob((_) async {
// if this throws, it will be retried automaticallyreturnawait api.fetchData();
}, retryTime: 3);
onError callback (v3.0.0+)
Handle errors at the queue level without parsing events:
This package would be useful if you have multiple widgets in a screen or even in multiple screens that need to do some async requests that are related to each other.
For examples:
To make one request from a widget wait for another request from another widget to finish.
To avoid multiple requests from the front end hitting the backend in a short time, which would confuse the backend.