TestService

Afficher les obsolètes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Service

Le TestService est un service utilisé par Roblox à l'interne pour effectuer des tests analytiques sur leur moteur. Cela rend possible d'écrire des tests sophistiqués directement dans un jeu.

Macros

Les scripts qui s'exécutent à l'intérieur du TestService (via TestService:Run() ) ont accès à des macros spéciaux qui invoquent directement des fonctions sous le TestService. Les macros sont en fait des substitutions pour de grands blocs de code qui ne devraient pas être réécrits à chaque fois que vous les appelez.

RBX_VÉRIFIER

Cette macro effectue des tests avec des appels à la fonction TestService:Check().

<tr>

  <td>RBX\_CHECK(cond)</td>

  <td>cond == oui</td>

</tr>



<tr>

  <td>RBX\_CHECK\_MESSAGE(cond, failMsg)</td>

  <td>cond == oui</td>

</tr>



<tr>

  <td>RBX\_CHECK\_THROW(CODE)</td>

  <td>pcall(fonction() CODE terminer) == faux</td>

</tr>



<tr>

  <td>RBX\_CHECK\_NO\_THROW (CODE)</td>

  <td>pcall(fonction() CODE terminer) == vrai</td>

</tr>



<tr>

  <td>RBX\_CHECK\_EQUAL(a, b)</td>

  <td>a == b</td>

</tr>



<tr>

  <td>RBX\_CHECK\_NE(a, b)</td>

  <td>a# b</td>

</tr>



<tr>

  <td>RBX\_CHECK\_GE(a, b)</td>

  <td>un >= b</td>

</tr>



<tr>

  <td>RBX\_CHECK\_LE(a, b)</td>

  <td>a≤b</td>

</tr>



<tr>

  <td>RBX\_CHECK\_GT(a, b)</td>

  <td>a > b</td>

</tr>



<tr>

  <td>RBX\_CHECK\_LT(a, b)</td>

  <td>un \< b</td>

</tr>
MacroCondition de test

RBX_EXIGER

Cette macro effectue des tests avec des appels à la fonction TestService:Require().

<tr>

  <td>RBX\_REQUIRE(cond)</td>

  <td>cond == oui</td>

</tr>



<tr>

  <td>RBX\_REQUIRE\_Messages(cond, failMsg)</td>

  <td>cond == oui</td>

</tr>



<tr>

  <td>RBX\_REQUIRE\_THROW (CODE)</td>

  <td>pcall(fonction() CODE terminer) == faux</td>

</tr>



<tr>

  <td>RBX\_REQUIRE\_NO\_THROW (CODE)</td>

  <td>pcall(fonction() CODE terminer) == vrai</td>

</tr>



<tr>

  <td>RBX\_REQUIRE\_EQUAL(a, b)</td>

  <td>a == b</td>

</tr>



<tr>

  <td>RBX\_REQUIRE\_NE(a, b)</td>

  <td>a# b</td>

</tr>



<tr>

  <td>RBX\_REQUIRE\_GE(a, b)</td>

  <td>un >= b</td>

</tr>



<tr>

  <td>RBX\_REQUIRE\_LE(a, b)</td>

  <td>a≤b</td>

</tr>



<tr>

  <td>RBX\_REQUIRE\_GT(a, b)</td>

  <td>a > b</td>

</tr>



<tr>

  <td>RBX\_REQUIRE\_LT(a, b)</td>

  <td>un \< b</td>

</tr>
MacroCondition de test

RBX_AVERTISSEMENT

Cette macro effectue des tests avec des appels à la fonction TestService:Warn().

<tr>

  <td>RBX\_WARN(cond)</td>

  <td>cond == oui</td>

</tr>



<tr>

  <td>RBX\_WARN\_MESSAGE(cond, failMsg)</td>

  <td>cond == oui</td>

</tr>



<tr>

  <td>RBX\_WARN\_THROW(CODE)</td>

  <td>pcall(fonction() CODE terminer) == faux</td>

</tr>



<tr>

  <td>RBX\_WARN\_NO\_THROW (CODE)</td>

  <td>pcall(fonction() CODE terminer) == vrai</td>

</tr>



<tr>

  <td>RBX\_WARN\_ÉQUAL(a, b)</td>

  <td>a == b</td>

</tr>



<tr>

  <td>RBX\_WARN\_NE(a, b)</td>

  <td>a# b</td>

</tr>



<tr>

  <td>RBX\_WARN\_GE(a, b)</td>

  <td>un >= b</td>

</tr>



<tr>

  <td>RBX\_WARN\_LE(a, b)</td>

  <td>a≤b</td>

</tr>



<tr>

  <td>RBX\_WARN\_GT(a, b)</td>

  <td>a > b</td>

</tr>



<tr>

  <td>RBX\_WARN\_LT(a, b)</td>

  <td>un \< b</td>

</tr>
MacroCondition de test

Macros supplémentaires

<tr>

  <td>RBX\_ERROR(Message)</td>

  <td>Appelle directement la fonction <code>Class.TestService:Error()</code>.</td>

</tr>



<tr>

  <td>RBX\_FAIL(Message)</td>

  <td>Appelle directement la fonction <code>Class.TestService:Fail()</code>.</td>

</tr>



<tr>

  <td>RBX\_Messages(msg)</td>

  <td>Appelle directement la fonction <code>Class.TestService:Message()</code>.</td>

</tr>
MacroDescription

Résumé

Propriétés

  • AutoRuns:bool
    Lecture parallèle

    Si elle est réglée sur vrai, le jeu s'exécutera lorsque la méthode Class.TestService:Run() du TestService sera appelée.

  • Description:string
    Lecture parallèle

    Une description du test qui est en cours d'exécution.

  • ErrorCount:number
    Lecture uniquement
    Non répliqué
    Lecture parallèle

    Mesure le nombre d'erreurs qui ont été enregistrées dans la session de test.

  • ExecuteWithStudioRun:bool
    Lecture parallèle

    Lorsqu'il est réglé sur vrai, le TestService s'exécutera lors de l'utilisation de l'action Courir dans Roblox Studio.

  • Is30FpsThrottleEnabled:bool
    Lecture parallèle

    Définit si le moteur de physique doit être accéléré à 30 FPS pendant que le test est exécuté.

  • IsPhysicsEnvironmentalThrottled:bool
    Lecture parallèle

    Définit si oui ou non l'environnement physique doit être ralenti pendant l'exécution de ce test.

  • IsSleepAllowed:bool
    Lecture parallèle

    Définit si les objets physiques peuvent ou non tomber endormis pendant que la simulation de test s'exécute.

  • NumberOfPlayers:number
    Lecture parallèle

    Le nombre de joueurs attendus dans ce test, le cas échéant.

  • SimulateSecondsLag:number
    Lecture parallèle

    Définit un certain nombre de latence supplémentaire par le joueur pendant la session de test.

  • TestCount:number
    Lecture uniquement
    Non répliqué
    Lecture parallèle

    Mesure le nombre de tests effectués dans la session de test.

  • Timeout:number
    Lecture parallèle

    La durée maximale de test que les tests sont autorisés à exécuter.

  • WarnCount:number
    Lecture uniquement
    Non répliqué
    Lecture parallèle

    Mesure le nombre de demandes d'avertissement enregistrées dans la session de test.

Afficher tous les hérités de Instance
Afficher tous les hérités de Object

Méthodes

  • Check(condition : bool,description : string,source : Instance,line : number):void

    Imprime le résultat de la condition à sortie.

  • Checkpoint(text : string,source : Instance,line : number):void

    Imprime « Test checkpoint: », suivi de texte, à la sortie, en texte bleu.

  • Done():void

    Imprimez le test terminé dans la sortie, en texte bleu.

  • Error(description : string,source : Instance,line : number):void

    Imprime un message rouge à la sortie, préfixé par TestService: .

  • Fail(description : string,source : Instance,line : number):void

    Indique une erreur fatale dans un lancerde test. Si ceci est appelé à l'intérieur d'un script s'exécutant dans le service de test, cela déclenchera un point d'arrêt sur la ligne qui a invoqué l'erreur.

  • Message(text : string,source : Instance,line : number):void

    Imprime le message de test, suivi du texte à l'sortie, en texte bleu.

  • Require(condition : bool,description : string,source : Instance,line : number):void

    Imprimez si une condition est vraie ainsi que le texte de description.

  • ScopeTime():Dictionary
  • Warn(condition : bool,description : string,source : Instance,line : number):void

    Imprime si une condition est vraie, sinon il imprime un avertissement.

  • isFeatureEnabled(name : string):bool
  • Run():void
    Rendement
    Sécurité des plugins

    Exécute des scripts qui sont parentés à TestService.

Afficher tous les hérités de Instance
Afficher tous les hérités de Object

Évènements

Afficher tous les hérités de Instance
Afficher tous les hérités de Object

Propriétés

AutoRuns

bool
Lecture parallèle

Si elle est réglée sur vrai, le jeu s'exécutera lorsque la méthode Class.TestService:Run() du TestService sera appelée.

Description

string
Lecture parallèle

Une description du test qui est en cours d'exécution.

ErrorCount

number
Lecture uniquement
Non répliqué
Lecture parallèle

Mesure le nombre d'erreurs qui ont été enregistrées dans la session de test.

ExecuteWithStudioRun

bool
Lecture parallèle

Lorsqu'il est réglé sur vrai, le TestService s'exécutera lors de l'utilisation de l'action Courir dans Roblox Studio.

Remarque :

  • Si la propriété TestService.NumberOfPlayers est définie sur une valeur supérieure à 0, l'exécution du jeu ouvrira NumberOfPlayers + 1 les fenêtres de studio, où une fenêtre est un serveur, et le reste sont des joueurs connectés à ce serveur.
  • Essayez de garder cette valeur dans une portée raisonnable (1 à 8 joueurs au maximum), ou bien votre ordinateur surchargera la CPU.

Is30FpsThrottleEnabled

bool
Lecture parallèle

Définit si le moteur de physique doit être accéléré à 30 FPS pendant que le test est exécuté.

IsPhysicsEnvironmentalThrottled

bool
Lecture parallèle

Définit si oui ou non l'environnement physique doit être ralenti pendant l'exécution de ce test.

IsSleepAllowed

bool
Lecture parallèle

Définit si les objets physiques peuvent ou non tomber endormis pendant que la simulation de test s'exécute.

NumberOfPlayers

number
Lecture parallèle

Le nombre de joueurs attendus dans ce test, le cas échéant.

SimulateSecondsLag

number
Lecture parallèle

Définit un certain nombre de latence supplémentaire par le joueur pendant la session de test.

TestCount

number
Lecture uniquement
Non répliqué
Lecture parallèle

Mesure le nombre de tests effectués dans la session de test.

Timeout

number
Lecture parallèle

La durée maximale de test que les tests sont autorisés à exécuter.

WarnCount

number
Lecture uniquement
Non répliqué
Lecture parallèle

Mesure le nombre de demandes d'avertissement enregistrées dans la session de test.

Afficher tous les hérités de Instance
Afficher tous les hérités de Object

Méthodes

Check

void

Si la condition est vraie, imprimez « Check passed : », suivi de la description à l'sortie, en texte bleu. Sinon, imprimez « Check failed : », à nouveau, suivi de la description, mais en texte rouge.

Paramètres

condition: bool
description: string
source: Instance
Valeur par défaut : "nil"
line: number
Valeur par défaut : 0

Retours

void

Échantillons de code

TestService:Check
local TestService = game:GetService("TestService")



TestService:Check(false, "example")

Checkpoint

void

Imprime « Test checkpoint : », suivi de texte , à la sortie, en texte bleu.

Paramètres

text: string
source: Instance
Valeur par défaut : "nil"
line: number
Valeur par défaut : 0

Retours

void

Échantillons de code

TestService:Checkpoint
local TestService = game:GetService("TestService")



TestService:Checkpoint("example")

Done

void

Imprimez Testing Done à la sortie, en texte bleu.


Retours

void

Échantillons de code

TestService:Done
local TestService = game:GetService("TestService")



TestService:Done()

Error

void

Imprime un message rouge à la sortie, préfixé par TestService: .

Paramètres

description: string
source: Instance
Valeur par défaut : "nil"
line: number
Valeur par défaut : 0

Retours

void

Échantillons de code

TestService:Error
local TestService = game:GetService("TestService")



TestService:Error("this is an error")

Fail

void

Indique une erreur fatale dans un lancerde test. Si ceci est appelé à l'intérieur d'un script s'exécutant dans le service de test, cela déclenchera un point d'arrêt sur la ligne qui a invoqué l'erreur.

Paramètres

description: string
source: Instance
Valeur par défaut : "nil"
line: number
Valeur par défaut : 0

Retours

void

Message

void

Imprimez un message de test, suivi de texte à l'sortie, en texte bleu.

Paramètres

text: string
source: Instance
Valeur par défaut : "nil"
line: number
Valeur par défaut : 0

Retours

void

Échantillons de code

TestService:Message
local TestService = game:GetService("TestService")



TestService:Message("example")

Require

void

Si condition est vrai, imprime Require passed: , suivi de description, dans la sortie en texte bleu. Sinon, imprime 1> require failed. Test terminé :1>, suivi de 4> description4>, dans la sortie en texte rouge.

Paramètres

condition: bool
description: string
source: Instance
Valeur par défaut : "nil"
line: number
Valeur par défaut : 0

Retours

void

Échantillons de code

TestService:Require
local TestService = game:GetService("TestService")



TestService:Require(false, "example")

ScopeTime

Dictionary

Retours

Dictionary

Warn

void

Si la condition condition est vraie, imprime la avertissement passé :, suivi par 1> description1>, dans la sortie, en texte bleu. Sinon, imprime le 4> Avertissement:4>, suivi par 7> description7>, dans la sortie, en texte jaune.

Paramètres

condition: bool
description: string
source: Instance
Valeur par défaut : "nil"
line: number
Valeur par défaut : 0

Retours

void

Échantillons de code

TestService:Warn
local TestService = game:GetService("TestService")



TestService:Warn(false, "this action is invalid")

isFeatureEnabled

bool

Paramètres

name: string

Retours

bool

Run

void
Rendement
Sécurité des plugins

Exécute des scripts qui sont parentés à TestService.


Retours

void
Afficher tous les hérités de Instance
Afficher tous les hérités de Object

Évènements

ServerCollectConditionalResult

Activé lorsque le serveur doit collecter un resultatsde test conditionnel.

Paramètres

condition: bool
text: string
script: Instance
line: number

ServerCollectResult

Activé lorsque le serveur devrait collecter un resultatsde test.

Paramètres

text: string
script: Instance
line: number

Afficher tous les hérités de Instance
Afficher tous les hérités de Object