run_on_thread

run_on_thread(thread: thread, source: string, ...: any) -> ()

Runs a string of Luau source inside the actor state a thread handle refers to. The thread must come from getactorthreads or getdeletedactors. This is the way to reach a destroyed actor’s state, which has no Actor instance for run_on_actor to take. Extra arguments are deep-copied in as varargs.

Parameters

thread

required

A thread handle for the actor state.

string

required

The Luau source to run.

any

Arguments copied into the state as varargs.

Example

for _, thread in getactorthreads() do
    run_on_thread(thread, [[ print(getgc ~= nil) ]])
end

Errors

Message	Condition
`an actor thread from getactorthreads or getdeletedactors was expected`	The thread was not a valid actor handle.
`code cannot be scheduled on an actor from a parallel phase`	Called from inside a parallel phase.

getactorthreads: where the thread handles come from.
run_on_actor: target by Actor instance instead.

Getting Started

Environment

Closures

Scripts

Reflection

Metatable

Instances

Cache

Signals

Signal

Actors

LuaStateProxy

Console

Input

Drawing

Filesystem

Encoding

Crypt

HTTP

WebSocket

RakNet

Miscellaneous

oth

Parameters

Example

Errors

​Parameters

​Example

​Errors

​Related

Parameters

Example

Errors

Related