Skip to content

Task ​

tyrus:task fornece cancelamento cooperativo, atrasos sem bloqueio, criação de tarefas concorrentes, canais tipados entre tarefas, combinators para compor várias tarefas juntas, um mutex para proteger um valor compartilhado entre tarefas, um reader-writer lock para permitir múltiplos leitores concorrentes, e um semaphore para limitar o acesso concorrente a uma região de código.

Imports ​

Importaçõesimport { cancel, isCancelled, sleep, sleepAsync, spawn, channel, joinAll, race, timeout, Mutex, RwLock, Semaphore, JoinHandle, Sender, Receiver } from "tyrus:task";

Itens Exportados ​

ItemAssinaturaFinalidade
cancel<T>(promise: Promise<T>, reason: string, graceMillis?: u64) => booleanCancela cooperativamente uma Promise pendente.
isCancelled() => booleanResponde, dentro de uma tarefa, se ela foi mandada parar.
sleep(ms: u64) => voidBloqueia a thread atual por um atraso.
sleepAsync(ms: u64) => Promise<void>Resolve após um atraso sem bloquear uma thread do executor.
spawn<T>(task: () => Promise<T>) => JoinHandle<T>Executa uma tarefa async em paralelo e devolve um handle para ela.
channel<T>(capacity?: usize) => [Sender<T>, Receiver<T>]Cria um canal tipado entre tarefas concorrentes.
joinAll<T>(handles: JoinHandle<T>[]) => Promise<T[]>Espera cada handle de um array se estabelecer.
race<T>(handles: JoinHandle<T>[]) => Promise<T>Resolve para o handle que se estabelecer primeiro, cancelando o resto.
timeout<T>(ms: u64, task: Promise<T>) => Promise<T>Limita quanto tempo uma Promise pode levar.
Mutex<T>(value: T) => Mutex<T>Protege acesso exclusivo a um valor compartilhado entre tarefas.
RwLock<T>(value: T) => RwLock<T>Permite múltiplos leitores concorrentes ou um escritor exclusivo sobre um valor compartilhado.
Semaphore(permits: usize) => SemaphoreLimita quantas tarefas entram em uma região de código ao mesmo tempo.

JoinHandle<T>, o handle que spawn devolve, e Sender<T>/Receiver<T>, o par que channel devolve, são exportados por tyrus:task: um binding cujo tipo é só inferido não precisa de import, mas nomear um deles numa anotação exige importá-lo, como em import { Sender, channel } from "tyrus:task";. Promise<T> é um tipo nativo e nunca precisa ser importado. MutexGuard<T>, o próprio tipo de retorno de Mutex<T>.lock()/.tryLock(), RwReadGuard<T>/RwWriteGuard<T>, os próprios tipos de guard de RwLock<T>, e SemaphorePermit, o próprio tipo de retorno de Semaphore.acquire()/.tryAcquire(), também são tipos nativos.

O Runtime ​

Todo item aqui roda sobre um runtime assíncrono compartilhado que não exige configuração. Runtime cobre o que um projeto pode decidir sobre ele: quantas threads de trabalho ele pode usar e o que acontece com uma tarefa ainda pendente quando o main termina.

Tasks e Promises ​

Promise.* e tyrus:task.* compartilham quatro nomes e não são intercambiáveis. Tasks e Promises cobre qual usar, e por que tyrus:task.race cancela os perdedores enquanto Promise.race não cancela.