Returns a traceback of the current function call stack as a string; in
other words, a description of the functions that have been called up to
this point. During debugging, this behaves like an error stack trace but
does not stop execution of the script.

The `level` parameter specifies what level of the call stack to consider,
with `1` being the call of `Library.debug.traceback()` itself, `2` being
the call of the function calling `Library.debug.traceback()`, and so on.
See the code sample below for an example of sequential function calls.

Note that this function will often return inaccurate results (compared to
the original source code) and that the format of the returned traceback
may change at any time. You should **not** parse the return value for
specific information such as script names or line numbers.

The following example includes sequential function calls; `fnB()` is
called, and it calls `fnA()` which then calls `Library.debug.traceback()`.

```lua
local function fnA()
	print(debug.traceback("Specific moment during fnA()"))
end

local function fnB()
	fnA()
end

-- Call function fnB() to begin traceback
fnB()
```


debug.traceback

message

level

The number of calls "up" the call stack to return.


Traceback of the current function call stack.


Returns a string of undefined format that describes the current function
call stack.


thread

A thread as returned by `Library.coroutine.create()`.


Allows programmatic inspection of the call stack. This function differs
from `Library.debug.traceback()` in that it guarantees the format of the
data it returns. This is useful for general logging and filtering purposes
as well as for sending the data to systems expecting structured input,
such as crash aggregation.

```lua
local function fnA()
	-- Output source identifier ("s") and line ("l") at levels 1 and 2
	print(debug.info(1, "sl"))  --> fnA() 3
	print(debug.info(2, "sl"))  --> fnA() 7
end

fnA()
```

Note that this function is similar to
[debug.getinfo](https://www.lua.org/pil/23.1.html), an unavailable part of
the standard Lua library which serves a similar purpose.


debug.info

Determines at what level of the call stack the information returned
should describe. A value of `1` represents the function which is
calling `Library.debug.info()`, a value of `2` represents the function
that called that function, and so on.


options

A string that describes what the returned information should
represent. It must only contain 0 or 1 instances of the characters
`slnaf`, each representing a piece of information:

- `s` ([string](/reference/engine/libraries/luau/strings)) — The function source identifier,
  equal to the full name of the script the function is defined in.
- `l` ([number](/reference/engine/libraries/luau/numbers)) — The line number of the function
  call represented by `level`.
- `n` ([string](/reference/engine/libraries/luau/strings)) — The name of the function; may be
  `nil` for anonymous functions and C functions without an assigned
  debug name.
- `a` ([number](/reference/engine/libraries/luau/numbers), [boolean](/reference/engine/libraries/luau/booleans)) —
  Arity of the function, which refers to the parameter count and
  whether the function is variadic.
- `f` ([function](/reference/engine/libraries/luau/functions)) — The function which was
  inspected.


Traverses the entire stack of current thread and returns a string
containing the call stack of target level details.


Allows programmatic inspection of the call stack. This function differs
from `Library.debug.traceback()` in that it guarantees the format of the
data it returns. This is useful for general logging and filtering purposes
as well as for sending the data to systems expecting structured input,
such as crash aggregation.

```lua
local function fnA()

end

local function fnB()

end

-- Output line ("l"), name ("n"), and identifier ("f") for both fnA() and fnB()
print(debug.info(fnA, "lnf"))  --> 1 fnA function: 0x75e3d3c398a81252
print(debug.info(fnB, "lnf"))  --> 5 fnB function: 0x6022a6dc5ccf4ab2
```

Note that this function is similar to
[debug.getinfo](https://www.lua.org/pil/23.1.html), an unavailable part of
the standard Lua library which serves a similar purpose.


function

The function of the call stack which the information returned should
describe.


A string that describes what the returned information should
represent. It must only contain 0 or 1 instances of the characters
`slnaf`, each representing a piece of information:

- `s` ([string](/reference/engine/libraries/luau/strings)) — The function source identifier,
  equal to the full name of the script the function is defined in.
- `l` ([number](/reference/engine/libraries/luau/numbers)) — The line that `function` is
  defined on.
- `n` ([string](/reference/engine/libraries/luau/strings)) — The name of the function; may be
  `nil` for anonymous functions and C functions without an assigned
  debug name.
- `a` ([number](/reference/engine/libraries/luau/numbers), [boolean](/reference/engine/libraries/luau/booleans)) —
  Arity of the function, which refers to the parameter count and
  whether the function is variadic.
- `f` ([function](/reference/engine/libraries/luau/functions)) — The function which was
  inspected.


Traverses the entire stack of current thread and returns a string
containing the call stack of target function details.


Traverses the entire stack of target thread and returns a string
containing the call stack of target level details.


Starts profiling for a
[MicroProfiler](/studio/microprofiler) label.


debug.profilebegin

label

The text that this
[MicroProfiler](/studio/microprofiler) label
displays.


Stops profiling for the most recent
[MicroProfiler](/studio/microprofiler) label that
`Library.debug.profilebegin()` opened.


debug.profileend

Stops profiling for the most recent label that
`Library.debug.profilebegin()` opened.


Returns the name of the current thread's active memory category.


debug.getmemorycategory

The current thread's active memory category.


Assigns a custom tag name to the current thread's memory category in the
[Developer Console](/studio/developer-console). Useful for
analyzing memory usage of multiple threads in the same script which would
otherwise be grouped together under the same tag/name. Returns the name of
the current thread's previous memory category.


debug.setmemorycategory

The current thread's previous memory category.


Assigns a custom tag to the current thread's memory category.


Resets the tag assigned by `Library.debug.setmemorycategory()` to the
automatically assigned value (typically, the script name).


debug.resetmemorycategory

debug

This library provides functions useful for debugging and profiling code.


An object that runs connected functions upon a specific occurrence.

Data Type

RBXScriptSignal

Luau

Tuple

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

A double-precision floating-point number.

number

A sequence of characters, such as letters, numbers, and symbols.

string

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.

debug

Resumo

Funções

Funções

traceback

Parâmetros

Devolução

traceback

Parâmetros

Devolução

info

Parâmetros

Devolução

info

Parâmetros

Devolução

info

Parâmetros

Devolução

profilebegin

Parâmetros

Devolução

profileend

Devolução

getmemorycategory

Devolução

setmemorycategory

Parâmetros

Devolução

resetmemorycategory

Devolução