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à

  • AutoRuns:bool
    Lettura Parallela

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

  • Description:string
    Lettura Parallela

    Una descrizione del test in esecuzione.

  • ErrorCount:number
    Sola Lettura
    Non Replicato
    Lettura Parallela

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

  • ExecuteWithStudioRun:bool
    Lettura Parallela

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

  • Is30FpsThrottleEnabled:bool
    Lettura Parallela

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

  • IsPhysicsEnvironmentalThrottled:bool
    Lettura Parallela

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

  • IsSleepAllowed:bool
    Lettura Parallela

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

  • NumberOfPlayers:number
    Lettura Parallela

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

  • SimulateSecondsLag:number
    Lettura Parallela

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

  • TestCount:number
    Sola Lettura
    Non Replicato
    Lettura Parallela

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

  • Timeout:number
    Lettura Parallela

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

  • WarnCount:number
    Sola Lettura
    Non Replicato
    Lettura Parallela

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

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

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.

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

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

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

bool
Lettura Parallela

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

Description

string
Lettura Parallela

Una descrizione del test in esecuzione.

ErrorCount

number
Sola Lettura
Non Replicato
Lettura Parallela

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

ExecuteWithStudioRun

bool
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

bool
Lettura Parallela

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

IsPhysicsEnvironmentalThrottled

bool
Lettura Parallela

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

IsSleepAllowed

bool
Lettura Parallela

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

NumberOfPlayers

number
Lettura Parallela

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

SimulateSecondsLag

number
Lettura Parallela

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

TestCount

number
Sola Lettura
Non Replicato
Lettura Parallela

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

Timeout

number
Lettura Parallela

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

WarnCount

number
Sola Lettura
Non Replicato
Lettura Parallela

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

bool

Parametri

name: string

Restituzioni

bool

Run

void
Resa
Sicurezza Plugin

Esegue gli script che sono parented a TestService.


Restituzioni

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

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

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