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

Vista general

Guías

Tutoriales

Referencia

Recursos

Arte

Diseño

Motor

Avatar

Nube

Este campo se puede establecer al crear un recurso, pero no se puede modificar por solicitudes posteriores.

Este campo se puede proporcionar en las solicitudes, pero nunca se incluirá en las respuestas.

Por clave API: {maxInPeriod} solicitudes cada {periodInSeconds} segundos por dirección IP

Este campo se puede configurar como respuestas, pero se ignorará en las solicitudes.

Se requieren los siguientes permisos de clave API para llamar a este extremo. Para obtener más información sobre cómo generar claves adecuadas, consulta [Gestionar claves API]({apiKeyReferenceDocLink}).

Los siguientes extremos están disponibles en rutas relativas a la URL base.

Esta cadena está formateada como [Timestamp](/cloud/reference/types#timestamp).

Un valor JSON puede ser `null`, `boolean`, `string`, `number`, `array`, u `object`.

Los siguientes ámbitos son necesarios para que tu aplicación OAuth 2.0 use este extremo. Para obtener más información sobre cómo registrar una aplicación de OAuth 2.0, consulta [Registro y revisión de aplicaciones]({oauth2ReferenceDocLink}).

Los siguientes objetos describen cargas que son aceptadas o devueltas. Ve cada extremo para más información sobre cuándo se utilizan estos objetos.

Esto permite ver información sobre tus recursos.

Esto permite cargar y actualizar recursos a Roblox.

Esto te permite ver información sobre tus productos de la Tienda de creadores.

Esto te permite modificar la información sobre tus productos de la Tienda de creadores.

Esto permite ver información sobre tus grupos.

Esto te permite gestionar las solicitudes de unión a grupo para tu cuenta.

Esto permite ver información sobre tu inventario.

Esta acción permite publicar mensajes en nombre de los usuarios.

Esto permite enviar notificaciones de tu experiencia a los usuarios

Esto permite enumerar los secretos asociados a tu experiencia.

Esto permite crear y actualizar secretos asociados a tu experiencia.

Permite leer información sobre el lugar.

Permite editar información sobre el lugar.

Esta operación permite el acceso a la publicación de nuevas versiones de experiencias en Roblox.

Permite leer información sobre la experiencia.

Permite editar información sobre la experiencia.

Te permite ver las restricciones de usuario en la experiencia.

Te permite editar las restricciones de usuario en la experiencia.

Permite leer el estado Premium y verificado del usuario.

Esto te permite ver las cuentas sociales de un usuario.

Activa la funcionalidad de inicio de sesión único

Da acceso a leer la información de tu perfil

Valor predeterminado: {defaultValueStart}{defaultValueEnd}

Una matriz es una lista ordenada de valores. Las matrices son útiles para almacenar colecciones de datos.

Un conjunto de pares clave-valor, donde las claves pueden ser cualquier número, cadena u objeto.

Esta función devuelve inmediatamente si es posible, pero puede producir el hilo que la llamó hasta que devuelva un valor.

Roblox ya no soporta o mantiene {nameStart}nombre{nameEnd}

Esta operación matemática ya no es soportada o mantenida por Roblox.

Este miembro no aparece en el navegador de objetos y no está destinado a un uso generalizado.

Solo se puede acceder a este miembro a través de la barra de comandos y de los plugins. Se producirá un error si se intenta acceder a través de los scripts.

Esta función no puede pausar el hilo de Lua que la llamó.

Se producirá un error al intentar acceder a este miembro a través de los scripts. Es posible acceder a él desde la ventana de propiedades de Roblox Studio.

Este miembro no aparece en el navegador de objetos de Roblox Studio.

No se puede crear una instancia de esta clase con el constructor Instance.new.

Roblox no replica este miembro a través de su límite entre servidor y cliente.

El código Lua no puede acceder a este miembro. Puedes cambiar su valor desde la ventana de propiedades en Roblox Studio.

El comportamiento de replicación de este objeto depende del jugador que lo posee.

Este miembro es de solo lectura. Se producirá un error al intentar escribir a este miembro.

Esta propiedad es de solo lectura y es segura para leer en hilos no sincronizados. Escribir en ella producirá un error.

Esta propiedad es de solo lectura y es seguro leerla en hilos no sincronizados. Se producirá un error al intentar escribir en ella.

Se puede acceder a este miembro solo en CoreScripts.

Solo Roblox CoreScripts puede acceder a este miembro y no se puede utilizar por los Jugadores.

Puedes leer y escribir en esta propiedad de forma segura desde múltiples hilos.

Esta clase es un singleton de nivel superior. Recupera una instancia de esta clase con la función GetService.

Múltiples hilos pueden escribir en esta propiedad, por lo que no es seguro leerla desde hilos no sincronizados.

Esta función pausa el hilo Lua que la llamó hasta que devuelva un resultado. Esta acción no interrumpe otros scripts.

Aprende cómo crear contenidos exitosos en Roblox con guías integrales, muestras de código, referencias y tutoriales.


{pageTitle} | {SiteName}

título

No se puede añadir al inventario

La muestra de código {title} se añadió a tu inventario.

La versión {versionNumber} incluye mejoras generales de rendimiento y correcciones de errores. Revisa nuestras otras notas de publicación para ver el estado de las mejoras y errores específicos.

No incluyas información personal o privada. Máximo de {maxDescriptionLength} palabras.

Se requiere un mínimo de {minDescriptionLength} palabras en la descripción.

Notas de lanzamiento para Roblox Studio versión {versionNumber}

Estamos trabajando en cosas aún más increíbles. Gracias por tu paciencia.

Al hacer clic en Continuar, se te dirigirá a {redirectLinkStart}{redirectLinkEnd}

Este sitio no es propiedad de Roblox, ni está gestionado por Roblox. Pueden tener diferentes términos y políticas de privacidad.

task

Resumen

Funciones

Funciones

spawn

Parámetros

Devuelve

defer

Parámetros

Devuelve

delay

Parámetros

Devuelve

desynchronize

Devuelve

synchronize

Devuelve

wait

Parámetros

Devuelve

cancel

Parámetros

Devuelve