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 service de test est un service utilisé par Roblox internement pour exécuter des tests analytiques sur son moteur.Cela permet d'écrire des tests sophistiqués directement dans un jeu.

Macros

Les scripts qui sont exécutés à l'intérieur du TestService (via TestService:Run() ) ont accès à des macros spéciales qui invoquent directement des fonctions sous le TestService.Les macros sont essentiellement des substitutions pour de grands blocs de code qui ne devraient pas avoir besoin d'être réécrits chaque fois que vous voulez les appeler.

RBX_CHECK

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

<th>Condition de test</th>

</tr>



<tr>

  <td>RBX_CHECK(cond)</td>



  <td>cond == vrai</td>

</tr>



<tr>

  <td>RBX_CHECK_MESSAGE(cond, failMsg)</td>



  <td>cond == vrai</td>

</tr>



<tr>

  <td>RBX_CHECK_THROW(CODE)</td>



  <td>pcall(function() 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>a >= 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>a < b</td>

</tr>
Macro

RBX_REQUIRE

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

<th>Condition de test</th>

</tr>



<tr>

  <td>RBX_REQUIRE(cond)</td>



  <td>cond == vrai</td>

</tr>



<tr>

  <td>RBX_REQUIRE_MESSAGE(cond, failMsg)</td>



  <td>cond == vrai</td>

</tr>



<tr>

  <td>RBX_REQUIRE_THROW(CODE)</td>



  <td>pcall(function() 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>a >= 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>a < b</td>

</tr>
Macro

RBX_WARN

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

<th>Condition de test</th>

</tr>



<tr>

  <td>RBX_WARN(cond)</td>



  <td>cond == vrai</td>

</tr>



<tr>

  <td>RBX_WARN_MESSAGE(cond, failMsg)</td>



  <td>cond == vrai</td>

</tr>



<tr>

  <td>RBX_WARN_THROW(CODE)</td>



  <td>pcall(function() 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_EQUAL(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>a >= 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>a < b</td>

</tr>
Macro

Macros supplémentaires

<th>Avertissement</th>

</tr>



<tr>

  <td>RBX_ERREUR(msg)</td>



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

</tr>



<tr>

  <td>RBX_FAIL(msg)</td>



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

</tr>



<tr>

  <td>RBX_MESSAGE(msg)</td>



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

</tr>
Macro

Résumé

Propriétés

  • AutoRuns:boolean
    Lecture parallèle

    Si la valeur est définie sur vrai, le jeu commencera à s'exécuter lorsque la méthode TestService:Run() du TestService sera appelée.

  • Description:string
    Lecture parallèle

    Une description du test qui est exécuté.

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

    Détermine le nombre d'erreurs enregistrées dans la session de test.

  • ExecuteWithStudioRun:boolean
    Lecture parallèle

    Lorsqu'il est défini sur true, le service de test sera exécuté lors de l'utilisation de l'action exécuter dans Roblox Studio.

  • IsPhysicsEnvironmentalThrottled:boolean
    Lecture parallèle

    Définit si l'environnement physique doit être limité ou non lors de l'exécution de ce test.

  • IsSleepAllowed:boolean
    Lecture parallèle

    Définit si les objets physiques peuvent ou non s'endormir pendant la simulation de test.

  • NumberOfPlayers:number
    Lecture parallèle

    Le nombre de joueurs attendus dans ce test, si nécessaire.

  • SimulateSecondsLag:number
    Lecture parallèle

    Définit un montant spécifique de latence supplémentaire que les joueurs ressentent pendant la session de test.

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

    Détermine le nombre de demandes de test enregistrées dans la session de test.

  • ThrottlePhysicsToRealtime:boolean
    Lecture parallèle
  • Timeout:number
    Lecture parallèle

    Quantité maximum de temps pendant lequel les tests sont autorisés à s'exécuter.

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

    Détermine le nombre d'appels d'avertissement enregistrés 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 : boolean,description : string,source : Instance,line : number):()

    Imprime le résultat de la condition à l'sortie.

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

    Imprime "Point de contrôle de test : ", suivi de texte, à la sortie, en texte bleu.

  • Done():()

    Impressions de tests terminées à l'sortie, en texte bleu.

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

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

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

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

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

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

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

    Imprime si une condition est vraie avec le texte de description.

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

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

  • isFeatureEnabled(name : string):boolean
  • Run():()
    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

boolean
Lecture parallèle

Si la valeur est définie sur vrai, le jeu commencera à s'exécuter lorsque la méthode TestService:Run() du TestService sera appelée.

Description

string
Lecture parallèle

Une description du test qui est exécuté.

ErrorCount

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

Détermine le nombre d'erreurs enregistrées dans la session de test.

ExecuteWithStudioRun

boolean
Lecture parallèle

Lorsqu'il est défini sur true, le service de test sera exécuté lors de l'utilisation de l'action exécuter 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 les fenêtres NumberOfPlayers + 1 du 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 plage rationnelle (1 à 8 joueurs au maximum), sinon le processeur de votre ordinateur sera surchargé.

IsPhysicsEnvironmentalThrottled

boolean
Lecture parallèle

Définit si l'environnement physique doit être limité ou non lors de l'exécution de ce test.

IsSleepAllowed

boolean
Lecture parallèle

Définit si les objets physiques peuvent ou non s'endormir pendant la simulation de test.

NumberOfPlayers

number
Lecture parallèle

Le nombre de joueurs attendus dans ce test, si nécessaire.

SimulateSecondsLag

number
Lecture parallèle

Définit un montant spécifique de latence supplémentaire que les joueurs ressentent pendant la session de test.

TestCount

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

Détermine le nombre de demandes de test enregistrées dans la session de test.

ThrottlePhysicsToRealtime

boolean
Lecture parallèle

Timeout

number
Lecture parallèle

Quantité maximum de temps pendant lequel les tests sont autorisés à s'exécuter.

WarnCount

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

Détermine le nombre d'appels d'avertissement enregistrés dans la session de test.

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

Méthodes

Check

()

Si la condition est vraie, imprime « Check passed : », suivi par la description de la sortie, en texte bleu.Sinon, imprime "Échec de la vérification : ", à nouveau, suivi de la description, mais en texte rouge.

Paramètres

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

Retours

()

Échantillons de code

This code would print Check failed: example to the output, in red text.

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



TestService:Check(false, "example")

Checkpoint

()

Imprime « Point de contrôle de test : », suivi de texte , à la sortie, en texte bleu.

Paramètres

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

Retours

()

Échantillons de code

This code would print Test checkpoint: example to the output, in blue text.

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



TestService:Checkpoint("example")

Done

()

Imprime Test terminé à la sortie, en texte bleu.


Retours

()

Échantillons de code

This code would print Testing Done to the output, in blue text.

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



TestService:Done()

Error

()

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

Paramètres

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

Retours

()

Échantillons de code

This will print TestService: "This is an error" to the output.

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



TestService:Error("this is an error")

Fail

()

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

Paramètres

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

Retours

()

Message

()

Imprime le message de test , suivi de texte à la sortie, en texte bleu.

Paramètres

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

Retours

()

Échantillons de code

This code would print Test message: example to the output, in blue text.

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



TestService:Message("example")

Require

()

Si condition est vrai, imprime Require passed: , suivi de description , à la sortie en texte bleu.Sinon, imprime Require failed. Test ended: , suivi de description , à la sortie en texte rouge.

Paramètres

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

Retours

()

Échantillons de code

This code would print Require passed: example to the output, in blue text.

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



TestService:Require(false, "example")

ScopeTime

Dictionary

Retours

Dictionary

Warn

()

Si la condition est vraie, imprime Avertissement passé : , suivi de description , à l'entrée, en texte bleu.Sinon, imprime Avertissement : , suivi de description , à la sortie, en texte jaune.

Paramètres

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

Retours

()

Échantillons de code

This code would print "Warning: this action is invalid" to the output, in yellow text.

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



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

isFeatureEnabled

boolean

Paramètres

name: string
Valeur par défaut : ""

Retours

boolean

Run

()
Rendement
Sécurité des plugins

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


Retours

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

Évènements

ServerCollectConditionalResult

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

Paramètres

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

ServerCollectResult

Tiré lorsque le serveur doit 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