TestService

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Assistenza

Il TestService è un servizio utilizzato da Roblox internamente per eseguire test analitici sul loro motore.Consente di scrivere test sofisticati proprio all'interno di un Gioco.

Macro

Gli script che vengono eseguiti all'interno del TestService (via TestService:Run() ) hanno accesso a macro speciali che invocano direttamente le funzioni sotto il TestService.Le macro sono sostituzioni essenzialmente per grandi blocchi di codice che non dovrebbero avere bisogno di essere riscritti ogni volta che vuoi chiamarli.

RBX_CHECK

Questa macro esegue test con chiamate alla funzione TestService:Check() .

<th>Condizione di test</th>

</tr>



<tr>

  <td>RBX_CHECK(cond)</td>



  <td>cond == vero</td>

</tr>



<tr>

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



  <td>cond == vero</td>

</tr>



<tr>

  <td>RBX_CHECK_THROW(CODICE)</td>



  <td>pcall(funzione() CODE Terminare) == falso</td>

</tr>



<tr>

  <td>RBX_CHECK_NO_THROW(CODICE)</td>



  <td>pcall(funzione() CODE Terminare) == vero</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>
Macerazione

RBX_REQUIRE

Questa macro esegue test con chiamate alla funzione TestService:Require() .

<th>Condizione di test</th>

</tr>



<tr>

  <td>RBX_REQUIRE(cond)</td>



  <td>cond == vero</td>

</tr>



<tr>

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



  <td>cond == vero</td>

</tr>



<tr>

  <td>RBX_REQUIRE_THROW(CODICE)</td>



  <td>pcall(funzione() CODE Terminare) == falso</td>

</tr>



<tr>

  <td>RBX_REQUIRE_NO_THROW(CODICE)</td>



  <td>pcall(funzione() CODE Terminare) == vero</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>
Macerazione

RBX_WARN

Questa macro esegue test con chiamate alla funzione TestService:Warn() .

<th>Condizione di test</th>

</tr>



<tr>

  <td>RBX_WARN(cond)</td>



  <td>cond == vero</td>

</tr>



<tr>

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



  <td>cond == vero</td>

</tr>



<tr>

  <td>RBX_WARN_THROW(CODICE)</td>



  <td>pcall(funzione() CODE Terminare) == falso</td>

</tr>



<tr>

  <td>RBX_WARN_NO_THROW(CODICE)</td>



  <td>pcall(funzione() CODE Terminare) == vero</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>
Macerazione

Macro aggiuntive

<th>Descrizione</th>

</tr>



<tr>

  <td>RBX_ERROR(msg)</td>



  <td>Chiama direttamente la funzione <code>Class.TestService:Error()</code>.</td>

</tr>



<tr>

  <td>RBX_FAIL(msg)</td>



  <td>Chiama direttamente la funzione <code>Class.TestService:Fail()</code>.</td>

</tr>



<tr>

  <td>RBX_MESSAGE(msg)</td>



  <td>Chiama direttamente la funzione <code>Class.TestService:Message()</code>.</td>

</tr>
Macerazione

Sommario

Proprietà

  • AutoRuns:boolean
    Lettura Parallela

    Se impostato su vero, il gioco inizierà a funzionare quando verrà chiamato il metodo TestService:Run() del TestService.

  • Description:string
    Lettura Parallela

    Una descrizione del test in esecuzione.

  • ErrorCount:number
    Sola Lettura
    Non Replicato
    Lettura Parallela

    Misura quante errori sono stati registrati nella Sessionedi test.

  • ExecuteWithStudioRun:boolean
    Lettura Parallela

    Quando è impostato su vero, il TestService verrà eseguito quando si utilizza l'azione Esegui in Roblox Studio.

  • IsPhysicsEnvironmentalThrottled:boolean
    Lettura Parallela

    Imposta se l'ambiente fisico debba essere ridotto o meno durante l'esecuzione di questo test.

  • IsSleepAllowed:boolean
    Lettura Parallela

    Imposta se gli oggetti fisici saranno o meno autorizzati a dormire mentre viene eseguita la simulazione del test.

  • NumberOfPlayers:number
    Lettura Parallela

    Il numero di giocatori attesi in questo test, se qualcuno.

  • SimulateSecondsLag:number
    Lettura Parallela

    Imposta una quantità specifica di ritardo aggiuntivo sperimentato dai giocatori durante la Sessionedi test.

  • TestCount:number
    Sola Lettura
    Non Replicato
    Lettura Parallela

    Misura quante chiamate di test sono state registrate nella Sessionedi test.

  • ThrottlePhysicsToRealtime:boolean
    Lettura Parallela

    Imposta se il test debba essere limitato per simulare il tempo secondo il tempo del mondo reale o il più veloce possibile.

  • Timeout:number
    Lettura Parallela

    La quantità massima di tempo per cui i test sono autorizzati a funzionare.

  • WarnCount:number
    Sola Lettura
    Non Replicato
    Lettura Parallela

    Misura quante chiamate di avvertimento sono state registrate nella Sessionedi test.

Visualizza tutti gli elementi ereditati da Instance
Visualizza tutti gli elementi ereditati da Object

Metodi

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

    Stampa il risultato della condizione all'Output.

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

    Stampa "Test checkpoint: ", seguito da testo, all'Output, in testo blu.

  • Done():()

    Stampa Test Done all'Output, in testo blu.

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

    Stampa un messaggio rosso all'Output, prefisso da TestService: .

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

    Indica un errore fatale durante l'Eseguiredi un TestService.Se questo viene chiamato all'interno di uno script in esecuzione all'interno del TestService, verrà inizializzato un punto di interruzione sulla linea che ha invocato l'errore.

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

    Stampa il Messaggiodi prova, seguito da testo all'Output, in testo blu.

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

    Stampa se una condizione è vera insieme al testo della descrizione.

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

    Stampa se una condizione è vera, altrimenti stampa un avviso.

  • isFeatureEnabled(name : string):boolean
  • Run():()
    Resa
    Sicurezza Plugin

    Esegue gli script che sono parented a TestService.

Visualizza tutti gli elementi ereditati da Instance
Visualizza tutti gli elementi ereditati da Object

Eventi

Visualizza tutti gli elementi ereditati da Instance
Visualizza tutti gli elementi ereditati da Object

Proprietà

AutoRuns

boolean
Lettura Parallela

Se impostato su vero, il gioco inizierà a funzionare quando verrà chiamato il metodo TestService:Run() del TestService.

Description

string
Lettura Parallela

Una descrizione del test in esecuzione.

ErrorCount

number
Sola Lettura
Non Replicato
Lettura Parallela

Misura quante errori sono stati registrati nella Sessionedi test.

ExecuteWithStudioRun

boolean
Lettura Parallela

Quando è impostato su vero, il TestService verrà eseguito quando si utilizza l'azione Esegui in Roblox Studio.

Nota:

  • Se la proprietà TestService.NumberOfPlayers è impostata su un valore superiore a 0, l'esecuzione del gioco aprirà le finestre di studio NumberOfPlayers + 1, dove una finestra è un Servere il resto sono giocatori connessi a quel Server.
  • Cerca di mantenere questo valore all'interno di un intervallo razionale (1 a 8 giocatori al massimo), altrimenti la CPU del tuo computer sarà sovraccarica.

IsPhysicsEnvironmentalThrottled

boolean
Lettura Parallela

Imposta se l'ambiente fisico debba essere ridotto o meno durante l'esecuzione di questo test.

IsSleepAllowed

boolean
Lettura Parallela

Imposta se gli oggetti fisici saranno o meno autorizzati a dormire mentre viene eseguita la simulazione del test.

NumberOfPlayers

number
Lettura Parallela

Il numero di giocatori attesi in questo test, se qualcuno.

SimulateSecondsLag

number
Lettura Parallela

Imposta una quantità specifica di ritardo aggiuntivo sperimentato dai giocatori durante la Sessionedi test.

TestCount

number
Sola Lettura
Non Replicato
Lettura Parallela

Misura quante chiamate di test sono state registrate nella Sessionedi test.

ThrottlePhysicsToRealtime

boolean
Lettura Parallela

Imposta se il test debba essere limitato per simulare il tempo secondo il tempo del mondo reale o il più veloce possibile.

Timeout

number
Lettura Parallela

La quantità massima di tempo per cui i test sono autorizzati a funzionare.

WarnCount

number
Sola Lettura
Non Replicato
Lettura Parallela

Misura quante chiamate di avvertimento sono state registrate nella Sessionedi test.

Visualizza tutti gli elementi ereditati da Instance
Visualizza tutti gli elementi ereditati da Object

Metodi

Check

()

Se la condizione è vera, stampa "Check passed: ", seguito da una descrizione all'Output, in testo blu.Altrimenti, stampa "Check failed: ", ancora una volta, seguito da una Descrizione, ma in testo rosso.

Parametri

condition: boolean
Valore predefinito: ""
description: string
Valore predefinito: ""
source: Instance
Valore predefinito: "nil"
line: number
Valore predefinito: 0

Restituzioni

()

Campioni di codice

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

()

Stampa " Test checkpoint: ", seguito da testo , all'Output, in testo blu.

Parametri

text: string
Valore predefinito: ""
source: Instance
Valore predefinito: "nil"
line: number
Valore predefinito: 0

Restituzioni

()

Campioni di codice

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

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



TestService:Checkpoint("example")

Done

()

Stampa Test Completati all'Output, in testo blu.


Restituzioni

()

Campioni di codice

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

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



TestService:Done()

Error

()

Stampa un messaggio rosso all'Output, prefisso da TestService: .

Parametri

description: string
Valore predefinito: ""
source: Instance
Valore predefinito: "nil"
line: number
Valore predefinito: 0

Restituzioni

()

Campioni di codice

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

()

Indica un errore fatale durante l'Eseguiredi un TestService.Se questo viene chiamato all'interno di uno script in esecuzione all'interno del TestService, verrà inizializzato un punto di interruzione sulla linea che ha invocato l'errore.

Parametri

description: string
Valore predefinito: ""
source: Instance
Valore predefinito: "nil"
line: number
Valore predefinito: 0

Restituzioni

()

Message

()

Stampa messaggio di test , seguito da testo all'Output, in testo blu.

Parametri

text: string
Valore predefinito: ""
source: Instance
Valore predefinito: "nil"
line: number
Valore predefinito: 0

Restituzioni

()

Campioni di codice

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

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



TestService:Message("example")

Require

()

Se condition è vero, stampa Require passed: , seguito da description , all'output in testo blu.Altrimenti, stampa Require failed. Test ended: , seguito da description , all'output in testo rosso.

Parametri

condition: boolean
Valore predefinito: ""
description: string
Valore predefinito: ""
source: Instance
Valore predefinito: "nil"
line: number
Valore predefinito: 0

Restituzioni

()

Campioni di codice

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

Restituzioni

Dictionary

Warn

()

Se la condizione è vera, stampa Avviso passato: , seguito da descrizione , all'Output, in testo blu.Altrimenti, stampa Avviso: , seguito da descrizione , all'Output, in testo giallo.

Parametri

condition: boolean
Valore predefinito: ""
description: string
Valore predefinito: ""
source: Instance
Valore predefinito: "nil"
line: number
Valore predefinito: 0

Restituzioni

()

Campioni di codice

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

Parametri

name: string
Valore predefinito: ""

Restituzioni

boolean

Run

()
Resa
Sicurezza Plugin

Esegue gli script che sono parented a TestService.


Restituzioni

()
Visualizza tutti gli elementi ereditati da Instance
Visualizza tutti gli elementi ereditati da Object

Eventi

ServerCollectConditionalResult

Spedito quando il server dovrebbe raccogliere un Risultatodi test condizionale.

Parametri

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

ServerCollectResult

Spedito quando il server dovrebbe raccogliere un Risultatodi test.

Parametri

text: string
script: Instance
line: number

Visualizza tutti gli elementi ereditati da Instance
Visualizza tutti gli elementi ereditati da Object