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

Vue d'ensemble

Guides

Tutoriels

Référence

Ressources

Conception

Moteur

Avatar

Cloud

Ce champ peut être défini lors de la création d'une ressource, mais ne peut pas être modifié par des requêtes ultérieures.

Ce champ peut être fourni dans les demandes, mais ne sera jamais inclus dans les réponses.

Par clé API : {maxInPeriod} demande toutes les {periodInSeconds} secondes par adresse IP

Ce champ peut être défini sur les réponses, mais sera ignoré dans les demandes.

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus
d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] ({apiKeyReferenceDocLink}).

Les points de terminaison suivants sont disponibles à des chemins relatifs à l'URL de base.

Cette chaîne est formatée comme un [FieldMask](/cloud/reference/types#fieldmask).

Une valeur JSON peut être `null`, `boolean`, `string`, `number`, `array`, ou `object`.

Les champs d'application suivants sont nécessaires pour que votre application OAuth 2.0 puisse utiliser ce point de terminaison. Pour plus d'informations sur l'enregistrement d'une application OAuth 2.0, voir [Enregistrement et révisions des applis]({oauth2ReferenceDocLink}).

Les objets suivants décrivent les charges utiles qui sont acceptées ou renvoyées. Voir chaque point de terminaison individuel pour plus d'informations sur l'utilisation de ces objets.

Ce string est formatée en tant que [Timestamp](/cloud/reference/types#timestamp).

Les champs d'application suivants sont nécessaires pour que votre application OAuth 2.0 puisse utiliser ce point de terminaison. Pour plus d'informations sur l'enregistrement d'une application OAuth 2.0, voir [Enregistrement et révision d'une application]. ({oauth2ReferenceDocLink}).

Cela permet de consulter des informations sur vos contenus.

Il permet de télécharger et de mettre à jour des actifs sur Roblox.

Cela vous permet d'afficher des informations sur vos produits de la Boutique du créateur.

Cela permet d'afficher des informations sur vos groupes.

Cela vous permet de gérer les demandes d'adhésion de groupe pour votre compte.

Cela permet de publier des messages au nom des utilisateurs.

Cela permet d'envoyer des notifications de votre expérience aux utilisateurs

Cela permet d'énumérer les secrets liés à ton expérience.

Cela permet de créer et de mettre à jour des secrets liés à ton expérience.

Donne la capacité de lire les informations sur les lieux.

Donne la possibilité d'éditer les informations du lieu.

Cette opération donne accès à la publication de nouvelles versions d'expériences à Roblox.

Donne la possibilité de lire des informations sur l'expérience.

Donne la possibilité de modifier les informations d'expérience.

Permet de voir les restrictions de l'utilisateur dans l'expérience.

Vous permet de modifier les restrictions d'utilisateur dans l'expérience.

Donne la possibilité de lire le statut premium et vérifié de l'utilisateur.

Cela vous permet de voir les comptes sociaux d'un utilisateur.

Cela active la fonctionnalité Single Sign-On

Cela vous donne accès à la lecture des informations de votre profil

Valeur par défaut : {defaultValueStart}{defaultValueEnd}

Un tableau est une liste ordonnée de valeurs. Les tableaux sont utiles pour stocker des collections de données.

Un ensemble de paires clé-valeur, où les clés peuvent être n'importe quel nombre, chaîne ou objet.

Cette fonction revient immédiatement si possible, mais peut céder le thread qui l'a appelée jusqu'à ce qu'elle puisse retourner une valeur.

{nameStart}nom{nameEnd} n'est plus supporté ou maintenu par Roblox.

Cette opération mathématique n'est plus prise en charge ou maintenue par Roblox.

Ce membre n'apparaît pas dans le navigateur d'objet et n'est pas destiné à une utilisation généralisée.

Ce membre n'est accessible que via la barre de commande. Tenter d'accéder à ce membre à partir de scripts provoque une erreur.

Cette fonction ne peut pas mettre en pause le thread Lua qui l’appelle.

Tenter d'accéder à ce membre dans les scripts provoque une erreur. Tu peux accéder à ce membre à partir de la fenêtre de propriété de Roblox Studios.

Ce membre n’apparaît pas dans le navigateur Objet de Roblox Studio.

Tu ne peux pas créer une instance de cette classe avec le constructeur Instance.new .

Roblox ne réplique pas ce membre à travers sa limite client serveur.

Le code Lua ne peut pas accéder à ce membre. Tu pourrais être en mesure de changer sa valeur depuis la fenêtre de la propriété dans Roblox Studio.

Le comportement de réplication de cet objet dépend du joueur qui le possède.

Ce membre n'est accessible que par le biais de la barre de commandes et des plugins uniquement. Tenter d'accéder à ce membre à partir de scripts provoque une erreur.

Ce membre est en lecture seule. Tenter d'écrire à ce membre provoque une erreur.

Cette propriété est en lecture seule et peut être lue en toute sécurité dans les threads non synchronisés. Toute tentative d'écriture dans cette propriété entraîne une erreur.

Ce membre n'est accessible que dans CoreScripts.

Seul Roblox CoreScripts peut accéder à ce membre, et il n’est pas utilisable par les joueurs.

Tu peux lire et écrire cette propriété en toute sécurité à partir de plusieurs threads.

Cette classe est un singleton de premier niveau. Récupére une instance de cette classe avec la fonction GetService.

Plusieurs threads peuvent potentiellement écrire dans cette propriété, donc il n'est pas sûr de lire à partir de threads non synchronisés.

Vous pouvez lire et écrire sur cette propriété en toute sécurité à partir de plusieurs threads.

Cette fonction met en pause le thread Lua qui l'a appelée jusqu'à ce qu'elle renvoie un résultat. Cela n'interrompt pas les autres scripts.

Apprenez à créer du contenu réussi sur Roblox avec des guides, des échantillons de code, des références et des tutoriels.


{pageTitle} | {SiteName}

titre

Impossible d'ajouter à l'inventaire

L'exemple de code {title} a été ajouté à votre inventaire.

La version {versionNumber} inclut des améliorations générales des performances et des corrections de bugs. Consultez nos autres notes de publication pour connaître l'état des améliorations et des bugs spécifiques.

Veuillez ne pas inclure d'informations privées ou personnelles. {maxDescriptionLength} mots maximum.

Minimum {minDescriptionLength} mots requis dans la description.

Notes de publication pour la version Roblox Studio {versionNumber}

Nous préparons des choses encore plus étonnantes. Merci de votre patience.

En cliquant sur "Continuer", vous serez dirigé vers {redirectLinkStart}{redirectLinkEnd}

Ce site n'est pas détenu ou exploité par Roblox. Ils peuvent avoir des conditions et des politiques de confidentialité différentes.

debug

Résumé

Fonctions

Fonctions

traceback

Paramètres

Retours

traceback

Paramètres

Retours

info

Paramètres

Retours

info

Paramètres

Retours

info

Paramètres

Retours

profilebegin

Paramètres

Retours

profileend

Retours

getmemorycategory

Retours

setmemorycategory

Paramètres

Retours

resetmemorycategory

Retours