Accepts a function or a thread (as returned by coroutine.create) and
calls/resumes it immediately through the engine's scheduler. Arguments
after the first are sent to the function/thread. This function does not
return any value, even if the provided function returns one immediately.

This function is based on the fastSpawn pattern rather than being a
replacement for the deprecated global `spawn` function. It is recommended
that this function be used in place of fastSpawn.

If the calling script is currently running in a serial execution phase,
then the spawned function or thread is resumed in the current serial
execution phase. If the calling script is currently running in a parallel
execution phase, then the spawned function or thread is resumed in the
current parallel execution phase. For more information, see
[Parallel Luau](/scripting/multithreading).


task.spawn

functionOrThread

A function or a thread returned by coroutine.create.


Arguments to send to the function or thread.


Calls/resumes a function/coroutine immediately through the engine
scheduler.


Accepts a function or a thread (as returned by coroutine.create) and
defers it until the next
[resumption cycle](https://devforum.roblox.com/t/1240569), at which point
it is resumed with the engine's scheduler like with
`Library.task.spawn()`. Arguments after the first are sent to the
function/thread. This function does not return any value, even if the
provided function returns one immediately.

This function should be used when a similar behavior to
`Library.task.spawn()` is desirable, but the thread does not need to run
immediately.

If the calling script is currently running in a serial execution phase,
then the deferred function or thread is resumed in a serial execution
phase. If the calling script is currently running in a parallel execution
phase, then the deferred function or thread is resumed in a parallel
execution phase. For more information, see
[Parallel Luau](/scripting/multithreading).


task.defer

Calls/resumes a function/coroutine on the next resumption cycle.


Accepts a function or a thread (as returned by coroutine.create) and
schedules it to be called/resumed on the next
`Class.RunService.Heartbeat|Heartbeat` after the given amount of time in
seconds has elapsed. Arguments after the second are sent to the
function/thread.

This function differs from the deprecated global `delay` function in that
**no throttling occurs**: on the very same Heartbeat step in which enough
time has passed, the function is guaranteed to be called/resumed.
Providing a duration of zero (0) will guarantee that the function is
called on the very next Heartbeat.

You can calculate the actual time passed by calling `Library.os.clock()`
upon scheduling and in the scheduled function.

If the calling script is currently running in a serial execution phase,
then the delayed function or thread is resumed in a serial execution
phase. If the calling script is currently running in a parallel execution
phase, then the delayed function or thread is resumed in a parallel
execution phase. For more information, see
[Parallel Luau](/scripting/multithreading).


task.delay

duration

The minimum number of seconds that must pass before the
function/thread is called/resumed.


Arguments to be passed to the function/thread when it is due to be
called/resumed.


Schedules a function/coroutine to be called/resumed on the next Heartbeat
after the given duration (in seconds) has passed, without throttling.


If the calling script is currently running in a serial execution phase,
`desynchronize` suspends the script and the script will be resumed in the
next parallel execution phase. If the calling script is currently running
in a parallel execution phase, `desynchronize` returns immediately and has
no effect.

Only scripts which are descendants of an Actor may call this method. If a
script outside of an Actor calls this method, an error will be raised.
ModuleScript's may also call `desynchronize` as long as the instantiation
of the module calling it was required by a script that is a descendant of
an Actor.

For more information, see
[Parallel Luau](/scripting/multithreading).


task.desynchronize

Causes the following code to be run in parallel.


If the calling script is currently running in a parallel execution phase,
`synchronize` suspends the script and the script will be resumed in the
next serial execution phase. If the calling script is currently running in
a serial execution phase, `synchronize` returns immediately and has no
effect.

Only scripts which are descendants of an Actor may call this method. If a
script outside of an Actor calls this method, an error will be raised.
ModuleScript's may also call `synchronize` as long as the instantiation of
the module calling it was required by a script that is a descendant of an
Actor.

For more information, see
[Parallel Luau](/scripting/multithreading).


task.synchronize

Causes the following code to be run in serial.


Yields the current thread until the given duration (in seconds) has
elapsed, then resumes the thread on the next
`Class.RunService.Heartbeat|Heartbeat` step. The actual amount of time
elapsed is returned.

If no duration is given, it will default to zero (0). This means the
thread resumes on the very next step, which is equivalent in behavior to
`RunService.Heartbeat:Wait()`

Unlike the deprecated global `wait`, this function **does not throttle**
and guarantees the resumption of the thread on the first Heartbeat that
occurs when it is due. This function also only returns the elapsed time
and nothing else.

If the calling script is currently running in a serial execution phase,
then the script is resumed in a serial execution phase. If the calling
script is currently running in a parallel execution phase, then the script
is resumed in a parallel execution phase. For more information, see
[Parallel Luau](/scripting/multithreading).


task.wait

The amount of time in seconds that should elapse before the current
thread is resumed.


Yields the current thread until the next Heartbeat in which the given
duration (in seconds) has passed, without throttling.


Cancels a thread and closes it, preventing it from being resumed manually
or by the task scheduler.

This function can be used with other members of the task library that
return a thread to cancel them before they are resumed. For example:

```lua
local thread = task.delay(5, function ()
  print("Hello world!")
end)

task.cancel(thread)
```

Note: Threads may be in a state where it is impossible to cancel them. For
example, the currently executing thread and threads that have resumed
another coroutine may not be cancelled. If this is the case, a lua error
will be generated.

However, code should not rely on specific thread states or conditions
causing `Library.task.cancel()` to fail. It is possible that future
updates will eliminate these constraints and allow threads in these states
to be successfully cancelled.


task.cancel

thread

Cancels a thread, preventing it from being resumed.


task

Allows for functions and threads to be coordinated with the Task Scheduler.


An object that runs connected functions upon a specific occurrence.

Data Type

RBXScriptSignal

Variant

Functions are blocks of code that can execute multiple times on command.

Luau

function

A double-precision floating-point number.

number

A function that executes alongside the main thread.

Library

coroutine

void

Visão geral

Guias

Tutoriais

Referência

Recursos

Arte

Design

Motor

Avatar

Nuvem

Este campo pode ser definido ao criar um recurso, mas não pode ser modificado por solicitações subsequentes.

Este campo pode ser fornecido em solicitações, mas nunca será incluído em respostas.

Por chave de API: {maxInPeriod} solicitações a cada {periodInSeconds} segundos por endereço IP

Este campo pode ser definido como respostas, mas será ignorado em solicitações.

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja [Gerenciando chaves API]({apiKeyReferenceDocLink}).

Os seguintes endpoints estão disponíveis em caminhos relativos à URL base.

Esta cadeia de caracteres está formatada como um [FieldMask](/cloud/reference/types#fieldmask).

Um valor JSON pode ser `null`, `boolean`, `string`, `number`, `array`, ou `object`.

Os seguintes escopos são necessários para que sua aplicação OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro do aplicativo e revisão]({oauth2ReferenceDocLink}).

Os seguintes objetos descrevem payloads que são aceitos ou retornados. Veja cada endpoint para mais informações sobre quando esses objetos são usados.

Esta cadeia de caracteres é formatada como um [Timestamp](/cloud/reference/types#timestamp).

Os seguintes escopos são necessários para que sua aplicação OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro e revisão do aplicativo]({oauth2ReferenceDocLink}).

Isto permite visualizar informações sobre seus ativos.

Isto permite enviar e atualizar ativos para a Roblox.

Isso permite que você visualize informações sobre seus produtos da Loja do Criador.

Isso permite que você modifique informações sobre seus produtos da Loja de Criadores.

Isso permite que você gerencie solicitações de adesão de grupos para sua conta.

Isto permite visualizar informações sobre seu inventário.

Isto permite publicar mensagens em nome de um usuário.

Isso permite o envio de notificações da sua experiência aos usuários

Isto permite listar segredos aliados à sua experiência.

Isto permite criar e atualizar segredos relacionados à sua experiência.

Concede a capacidade de ler informações do local.

Concede a capacidade de editar as informações do local.

Esta operação permite acesso para publicar novas versões de experiências para a Roblox.

Concede a capacidade de ler informações da experiência.

Concede a capacidade de editar informações da experiência.

Permite que você veja restrições de usuário na experiência.

Permite que você edite restrições de usuário na experiência.

Concede a capacidade de ler o status Premium e verificado do usuário.

Isso permite que você veja as contas sociais de um usuário.

Isto habilita a funcionalidade de logon único

Isso permite acesso à leitura das informações do seu perfil

Valor padrão: {defaultValueStart}{defaultValueEnd}

Um array é uma lista ordenada de valores. Arrays são úteis para armazenar coleções de dados.

Um conjunto de pares chave-valor, onde as chaves podem ser qualquer número, string ou objeto.

Essa função retorna imediatamente, se possível, mas pode gerar a sequência que a chamou até que possa retornar um valor.

{nameStart}nome{nameEnd} não é mais suportado ou mantido pela Roblox.

Essa operação matemática não é mais suportada ou mantida pela Roblox.

Este membro não aparece no navegador de objetos e não é para uso geral.

Este membro só é acessível somente através da barra de comandos. Tentar acessar este membro a partir de scripts causa um erro.

Esta função não pode pausar o tópico Lua que a chamou.

Tentar acessar este membro em scripts causa um erro. Você pode ser capaz de acessar este membro na janela de propriedades do Roblox Studio.

Este membro não aparece no Navegador de Objetos do Roblox Studio.

Não é possível criar uma instância desta classe com o construtor Instance.new.

A Roblox não replica este membro além do limite do seu servidor-cliente.

O código Lua não pode acessar este membro. Você pode ser capaz de alterar o valor dele na janela de propriedades do Roblox Studio.

O comportamento de replicação do objeto depende do jogador que o possui.

Este membro é acessível somente através da barra de comandos e plugins. Tentar acessar este membro a partir de scripts causa um erro.

Este membro é somente leitura. Tentar escrever para este membro causa um erro.

Esta propriedade é somente leitura e é segura para ler em tópicos não sincronizados. Tentar escrever nela causa um erro.

Esta propriedade é somente leitura e é segura para ler em threads não sincronizadas. Tentar escrever nela causa um erro.

Este membro é acessível somente no CoreScripts.

Somente o Roblox CoreScripts pode acessar este membro e ele não é utilizável por jogadores.

Você pode ler e escrever para esta propriedade com segurança a partir de várias threads.

Esta classe é uma singleton de alto nível. Recupere uma instância desta classe com a função GetService.

Várias threads podem potencialmente escrever para esta propriedade, então não é seguro ler a partir de threads não sincronizadas.

Você pode ler e escrever para esta propriedade com segurança a partir de vários tópicos.

Esta função pausa a thread Lua que a chamou até que ela retorne um resultado. Isto não interrompe outros scripts.

Aprenda a criar conteúdo bem-sucedido no Roblox com guias abrangentes, amostras de código, referência e tutoriais.


{pageTitle} | {SiteName}

título

Não é possível adicionar ao inventário

A amostra de código {title} foi adicionada ao seu inventário.

A versão {versionNumber} inclui melhorias gerais de desempenho e correções de bugs. Confira as nossas outras notas de lançamento sobre melhorias específicas e erros.

Não inclua informações privadas ou pessoais. No máximo {maxDescriptionLength} palavras.

Mínimo de {minDescriptionLength} palavras necessárias na descrição.

Notas de Lançamento para o Roblox Studio versão {versionNumber}

Estamos tornando as coisas ainda mais incríveis. Agradecemos sua paciência.

Clicando em "Continuar", você será direcionado(a) para {redirectLinkStart}{redirectLinkEnd}

Este site não pertence ou é operado pela Roblox. Ele pode ter diferentes termos e políticas de privacidade.

task

Resumo

Funções

Funções

spawn

Parâmetros

Devolução

defer

Parâmetros

Devolução

delay

Parâmetros

Devolução

desynchronize

Devolução

synchronize

Devolução

wait

Parâmetros

Devolução

cancel

Parâmetros

Devolução