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.

Macros

Gli script che vengono eseguiti all'interno del TestService (via TestService:Run() ) hanno accesso a macros speciali che invocano direttamente le funzioni sotto il TestService. I macros sono sostituzioni essenziali per grandi blocchi di codice che non dovrebbero essere ri scritti ogni volta che vuoi chiamarli.

RBX_CONTROLLO

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


<tr>
<td>RBX\_CHECK(cond)</td>
<td>condizioni di parità = vero</td>
</tr>
<tr>
<td>RBX\_CHECK\_MESSAGE(cond, fallMsg)</td>
<td>condizioni di parità = vero</td>
</tr>
<tr>
<td>RBX\_CHECK\_THROW (CODICE)</td>
<td>pcall(funzione() CODA Terminare) == false</td>
</tr>
<tr>
<td>RBX\_CHECK\_NO\_THROW (CODICE)</td>
<td>pcall(funzione() CODA 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>un \< b</td>
</tr>
MacroCondizione di prova

RBX_Richiesta

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


<tr>
<td>RBX\_REQUIRE (cond)</td>
<td>condizioni di parità = vero</td>
</tr>
<tr>
<td>RBX\_REQUIRE\_MESSAGE(cond, failMsg)</td>
<td>condizioni di parità = vero</td>
</tr>
<tr>
<td>RBX\_REQUIRE\_THROW (CODICE)</td>
<td>pcall(funzione() CODA Terminare) == false</td>
</tr>
<tr>
<td>RBX\_REQUIRE\_NO\_THROW (CODICE)</td>
<td>pcall(funzione() CODA 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>un \< b</td>
</tr>
MacroCondizione di prova

RBX_AVVISO

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


<tr>
<td>RBX\_WARN(cond)</td>
<td>condizioni di parità = vero</td>
</tr>
<tr>
<td>RBX\_WARN\_MESSAGE(cond, fallMsg)</td>
<td>condizioni di parità = vero</td>
</tr>
<tr>
<td>RBX\_WARN\_THROW (CODICE)</td>
<td>pcall(funzione() CODA Terminare) == false</td>
</tr>
<tr>
<td>RBX\_WARN\_NO\_THROW (CODICE)</td>
<td>pcall(funzione() CODA 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>un \< b</td>
</tr>
MacroCondizione di prova

Macros aggiuntivi


<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>
MacroDescrizione

Sommario

Proprietà

  • Lettura Parallela

    Se impostato su true, il gioco inizierà a funzionare quando il metodo TestService:Run() di TestService sarà chiamato.

  • Lettura Parallela

    Una descrizione del test in esecuzione.

  • Sola Lettura
    Non Replicato
    Lettura Parallela

    Misura il numero di errori che sono stati registrati nella Sessionedi test.

  • Lettura Parallela

    Quando impostato su true, il TestService verrà eseguito quando si utilizza l'azione Run in Roblox Studio.

  • Lettura Parallela

    Imposta se il motore fisico dovrebbe essere accelerato a 30 FPS mentre il test viene eseguito.

  • Imposta se o no l'ambiente fisico dovrebbe essere accelerato mentre si esegue questo test.

  • Lettura Parallela

    Imposta se gli oggetti fisici sono ammessi a dormire mentre la simulazione di test è in esecuzione.

  • Lettura Parallela

    Il numero di giocatori previsto in questo test, se presente.

  • Lettura Parallela

    Imposta un certo numero di latenza aggiuntiva esperienza dai giocatori durante la Sessionedi test.

  • Sola Lettura
    Non Replicato
    Lettura Parallela

    Misura il numero di chiamate di test che sono state registrate nella Sessionedi test.

  • Lettura Parallela

    La quantità massima di tempo che i test sono autorizzati a eseguire.

  • Sola Lettura
    Non Replicato
    Lettura Parallela

    Misura il numero di chiamate di avvertimento registrate nella Sessionedi test.

Metodi

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

    Stampa il risultato della condizione per l'Output.

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

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

  • Done():void

    Stampa il test completato nell'Output, in testo blu.

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

    Stampa un messaggio rosso per la Output, prefixato da TestService: .

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

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

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

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

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

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

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

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

  • Run():void
    Resa
    Sicurezza Plugin

    Esegue gli script che sono parented a TestService.

Eventi

Proprietà

AutoRuns

Lettura Parallela

Se impostato su true, il gioco inizierà a funzionare quando il metodo TestService:Run() di TestService sarà chiamato.

Description

Lettura Parallela

Una descrizione del test in esecuzione.

ErrorCount

Sola Lettura
Non Replicato
Lettura Parallela

Misura il numero di errori che sono stati registrati nella Sessionedi test.

ExecuteWithStudioRun

Lettura Parallela

Quando impostato su true, il TestService verrà eseguito quando si utilizza l'azione Run in Roblox Studio.

Nota:

  • Se la proprietà TestService.NumberOfPlayers è impostata su un valore superiore a 0, l'esecuzione del gioco apre NumberOfPlayers + 1 finestre di studio, in cui una finestra è un Servere le altre sono giocatori connessi a quel Server.
  • Cerca di mantenere questo valore entro un range razionale (1 a 8 giocatori al massimo), altrimenti il tuo computer inizierà a surriscaldarsi.

Is30FpsThrottleEnabled

Lettura Parallela

Imposta se il motore fisico dovrebbe essere accelerato a 30 FPS mentre il test viene eseguito.

IsPhysicsEnvironmentalThrottled

Lettura Parallela

Imposta se o no l'ambiente fisico dovrebbe essere accelerato mentre si esegue questo test.

IsSleepAllowed

Lettura Parallela

Imposta se gli oggetti fisici sono ammessi a dormire mentre la simulazione di test è in esecuzione.

NumberOfPlayers

Lettura Parallela

Il numero di giocatori previsto in questo test, se presente.

SimulateSecondsLag

Lettura Parallela

Imposta un certo numero di latenza aggiuntiva esperienza dai giocatori durante la Sessionedi test.

TestCount

Sola Lettura
Non Replicato
Lettura Parallela

Misura il numero di chiamate di test che sono state registrate nella Sessionedi test.

Timeout

Lettura Parallela

La quantità massima di tempo che i test sono autorizzati a eseguire.

WarnCount

Sola Lettura
Non Replicato
Lettura Parallela

Misura il numero di chiamate di avvertimento registrate nella Sessionedi test.

Metodi

Check

void

Se la condizione è vera, prints "Check passed: ", seguiti dalla descrizione all'Output, in blue text. Altrimenti, prints "Check failed: ", ancora, followed by Descrizione, ma in red text.

Parametri

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

Restituzioni

void

Campioni di codice

TestService:Check

local TestService = game:GetService("TestService")
TestService:Check(false, "example")

Checkpoint

void

Stampa " Checkpoint di prova: ", seguito da testo , all'Output, in testo blu.

Parametri

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

Restituzioni

void

Campioni di codice

TestService:Checkpoint

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

Done

void

Stampa Testing Done all'Output, in testo blu.


Restituzioni

void

Campioni di codice

TestService:Done

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

Error

void

Stampa un messaggio rosso per la Output, prefixato da TestService: .

Parametri

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

Restituzioni

void

Campioni di codice

TestService:Error

local TestService = game:GetService("TestService")
TestService:Error("this is an error")

Fail

void

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

Parametri

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

Restituzioni

void

Message

void

Stampa un messaggio di prova, seguito da testo al Output, in testo blu.

Parametri

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

Restituzioni

void

Campioni di codice

TestService:Message

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

Require

void

Se condition è vero, prints Require passed: , followed by description , to the output in blue text. Otherwise, prints 1> require failed. Test ended:1> , followed by 4> Descrizione4> , to the output in red text.

Parametri

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

Restituzioni

void

Campioni di codice

TestService:Require

local TestService = game:GetService("TestService")
TestService:Require(false, "example")

ScopeTime


Restituzioni

Warn

void

Se la condizione condizione è vera, prints Attenzione passata: , followed by descrizione , to the Output, in blue text. Altrimenti, prints Avviso: 2> , followed by 5>descrizione5> , to the Output, in yellow text.

Parametri

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

Restituzioni

void

Campioni di codice

TestService:Warn

local TestService = game:GetService("TestService")
TestService:Warn(false, "this action is invalid")

isFeatureEnabled

Parametri

name: string

Restituzioni

Run

void
Resa
Sicurezza Plugin

Esegue gli script che sono parented a TestService.


Restituzioni

void

Eventi

ServerCollectConditionalResult

Fired quando il server dovrebbe raccogliere un Risultatodi test condizionato.

Parametri

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

ServerCollectResult

Fired quando il server dovrebbe raccogliere un Risultatodi test.

Parametri

text: string
script: Instance
line: number