TestService

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Serviço

O TestService é um serviço usado pelo Roblox internamente para executar testes analíticos em seu motor.Torna possível escrever testes sofisticados dentro de um jogo.

Marcos

Scripts que são executados dentro do TestService (via TestService:Run() ) têm acesso a macros especiais que invocam diretamente funções sob o TestService.Macros são essencialmente substituições para grandes blocos de código que não devem precisar ser reescritos cada vez que você quiser chamá-los.

RBX_CHECK

Esta macro faz testes com chamadas para a função TestService:Check() .

<th>Condição de Teste</th>

</tr>



<tr>

  <td>RBX_CHECK(cond)</td>



  <td>cond == verdadeiro</td>

</tr>



<tr>

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



  <td>cond == verdadeiro</td>

</tr>



<tr>

  <td>RBX_CHECK_THROW(CÓDIGO)</td>



  <td>pcall(function() CÓDIGO terminar/parar/sair) == falso</td>

</tr>



<tr>

  <td>RBX_CHECK_NO_THROW(CÓDIGO)</td>



  <td>pcall(function() CÓDIGO terminar/parar/sair) == verdadeiro</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>
Microscópio

RBX_REQUIRE

Esta macro faz testes com chamadas para a função TestService:Require() .

<th>Condição de Teste</th>

</tr>



<tr>

  <td>RBX_REQUIRE(cond)</td>



  <td>cond == verdadeiro</td>

</tr>



<tr>

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



  <td>cond == verdadeiro</td>

</tr>



<tr>

  <td>RBX_REQUIRE_THROW(CÓDIGO)</td>



  <td>pcall(function() CÓDIGO terminar/parar/sair) == falso</td>

</tr>



<tr>

  <td>RBX_REQUIRE_NO_THROW(CÓDIGO)</td>



  <td>pcall(function() CÓDIGO terminar/parar/sair) == verdadeiro</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>
Microscópio

RBX_WARN

Esta macro faz testes com chamadas para a função TestService:Warn() .

<th>Condição de Teste</th>

</tr>



<tr>

  <td>RBX_WARN(cond)</td>



  <td>cond == verdadeiro</td>

</tr>



<tr>

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



  <td>cond == verdadeiro</td>

</tr>



<tr>

  <td>RBX_WARN_THROW(CÓDIGO)</td>



  <td>pcall(function() CÓDIGO terminar/parar/sair) == falso</td>

</tr>



<tr>

  <td>RBX_WARN_NO_THROW(CÓDIGO)</td>



  <td>pcall(function() CÓDIGO terminar/parar/sair) == verdadeiro</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>
Microscópio

Macros Adicionais

<th>Descrição</th>

</tr>



<tr>

  <td>RBX_ERRO(msg)</td>



  <td>Chama diretamente a função <code>Class.TestService:Error()</code>.</td>

</tr>



<tr>

  <td>RBX_FAILURE(msg)</td>



  <td>Chama diretamente a função <code>Class.TestService:Fail()</code>.</td>

</tr>



<tr>

  <td>RBX_MESSAGE(msg)</td>



  <td>Chama diretamente a função <code>Class.TestService:Message()</code>.</td>

</tr>
Microscópio

Resumo

Propriedades

  • AutoRuns:boolean
    Ler Parallel

    Se definido como verdadeiro, o jogo começará a funcionar quando o método TestService:Run() do TestService for chamado.

  • Description:string
    Ler Parallel

    Uma descrição do teste sendo executado.

  • ErrorCount:number
    Somente leitura
    Não replicado
    Ler Parallel

    Mede quantos erros foram registrados na sessão de teste.

  • ExecuteWithStudioRun:boolean
    Ler Parallel

    Quando definido como verdadeiro, o TestService será executado ao usar a ação Executar na Roblox Studio.

  • IsPhysicsEnvironmentalThrottled:boolean
    Ler Parallel

    Define se o ambiente de física deve ou não ser limitado durante a execução deste teste.

  • IsSleepAllowed:boolean
    Ler Parallel

    Define se objetos físicos poderão ou não dormir enquanto a simulação de teste estiver em andamento.

  • NumberOfPlayers:number
    Ler Parallel

    O número de jogadores esperados neste teste, se algum.

  • SimulateSecondsLag:number
    Ler Parallel

    Define uma quantidade específica de latência adicional experimentada pelos jogadores durante a sessão de teste.

  • TestCount:number
    Somente leitura
    Não replicado
    Ler Parallel

    Mede quantas chamadas de teste foram registradas na sessão de teste.

  • ThrottlePhysicsToRealtime:boolean
    Ler Parallel

    Define se o teste deve ser limitado para simular o tempo de acordo com o tempo do mundo real ou o mais rápido possível.

  • Timeout:number
    Ler Parallel

    A quantidade máxima de tempo que os testes são permitidos para executar.

  • WarnCount:number
    Somente leitura
    Não replicado
    Ler Parallel

    Medições de quantas chamadas de aviso foram registradas na sessão de teste.

Ver todos os herdados de Instance
Ver todos os herdados de Object

Métodos

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

    Imprime o resultado da condição para a saída.

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

    Imprime "Test checkpoint: ", seguido por texto, para a saída, em texto azul.

  • Done():()

    Impressões de teste feitas para a saída, em texto azul.

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

    Imprime uma mensagem vermelha para a saída, prefixada por TestService: .

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

    Indica um erro fatal em uma executardo TestService.Se isso for chamado dentro de um script executando dentro do TestService, isso iniciará um ponto de interrupção na linha que invocou o erro.

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

    Imprime a mensagem de teste, seguida por texto para a saída, em texto azul.

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

    Imprime se uma condição é verdadeira junto com o texto de descrição.

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

    Imprime se uma condição for verdadeira, caso contrário, imprime um aviso.

  • isFeatureEnabled(name : string):boolean
  • Run():()
    Rendimentos
    Segurança do plugin

    Executa scripts que são parentados ao TestService.

Ver todos os herdados de Instance
Ver todos os herdados de Object

Eventos

Ver todos os herdados de Instance
Ver todos os herdados de Object

Propriedades

AutoRuns

boolean
Ler Parallel

Se definido como verdadeiro, o jogo começará a funcionar quando o método TestService:Run() do TestService for chamado.

Description

string
Ler Parallel

Uma descrição do teste sendo executado.

ErrorCount

number
Somente leitura
Não replicado
Ler Parallel

Mede quantos erros foram registrados na sessão de teste.

ExecuteWithStudioRun

boolean
Ler Parallel

Quando definido como verdadeiro, o TestService será executado ao usar a ação Executar na Roblox Studio.

Nota:

  • Se a propriedade TestService.NumberOfPlayers for definida para um valor acima de 0, executar o jogo abrirá as janelas do estúdio NumberOfPlayers + 1, onde uma janela é um servidor e o resto são jogadores conectados a esse servidor.
  • Tente manter esse valor dentro de um alcance racional (1 a 8 jogadores no máximo), caso contrário, a CPU do seu computador ficará sobrecarregada.

IsPhysicsEnvironmentalThrottled

boolean
Ler Parallel

Define se o ambiente de física deve ou não ser limitado durante a execução deste teste.

IsSleepAllowed

boolean
Ler Parallel

Define se objetos físicos poderão ou não dormir enquanto a simulação de teste estiver em andamento.

NumberOfPlayers

number
Ler Parallel

O número de jogadores esperados neste teste, se algum.

SimulateSecondsLag

number
Ler Parallel

Define uma quantidade específica de latência adicional experimentada pelos jogadores durante a sessão de teste.

TestCount

number
Somente leitura
Não replicado
Ler Parallel

Mede quantas chamadas de teste foram registradas na sessão de teste.

ThrottlePhysicsToRealtime

boolean
Ler Parallel

Define se o teste deve ser limitado para simular o tempo de acordo com o tempo do mundo real ou o mais rápido possível.

Timeout

number
Ler Parallel

A quantidade máxima de tempo que os testes são permitidos para executar.

WarnCount

number
Somente leitura
Não replicado
Ler Parallel

Medições de quantas chamadas de aviso foram registradas na sessão de teste.

Ver todos os herdados de Instance
Ver todos os herdados de Object

Métodos

Check

()

Se a condição for verdadeira, imprime "Check passed: ", seguido por uma descrição para a saída, em texto azul.Caso contrário, imprime "Check failed: ", novamente, seguido por descrição, mas em texto vermelho.

Parâmetros

condition: boolean
Valor Padrão: ""
description: string
Valor Padrão: ""
source: Instance
Valor Padrão: "nil"
line: number
Valor Padrão: 0

Devolução

()

Amostras de código

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 " Checkpoint de teste: ", seguido por texto , para a saída, em texto azul.

Parâmetros

text: string
Valor Padrão: ""
source: Instance
Valor Padrão: "nil"
line: number
Valor Padrão: 0

Devolução

()

Amostras de código

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 Teste Feito para a saída, em texto azul.


Devolução

()

Amostras de código

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

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



TestService:Done()

Error

()

Imprime uma mensagem vermelha para a saída, prefixada por TestService: .

Parâmetros

description: string
Valor Padrão: ""
source: Instance
Valor Padrão: "nil"
line: number
Valor Padrão: 0

Devolução

()

Amostras de código

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 um erro fatal em uma executardo TestService.Se isso for chamado dentro de um script executando dentro do TestService, isso iniciará um ponto de interrupção na linha que invocou o erro.

Parâmetros

description: string
Valor Padrão: ""
source: Instance
Valor Padrão: "nil"
line: number
Valor Padrão: 0

Devolução

()

Message

()

Imprime mensagem de teste , seguida por texto para a saída, em texto azul.

Parâmetros

text: string
Valor Padrão: ""
source: Instance
Valor Padrão: "nil"
line: number
Valor Padrão: 0

Devolução

()

Amostras de código

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 for verdadeiro, imprime Require passed: , seguido por description , na saída em texto azul.Caso contrário, imprime Require failed. Test ended: , seguido por description , para a saída em texto vermelho.

Parâmetros

condition: boolean
Valor Padrão: ""
description: string
Valor Padrão: ""
source: Instance
Valor Padrão: "nil"
line: number
Valor Padrão: 0

Devolução

()

Amostras de código

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

Devolução

Dictionary

Warn

()

Se a condição for verdadeira, imprime Aviso passado: , seguido por descrição , para a saída, em texto azul.Caso contrário, imprime Aviso/advertência: , seguido por descrição , para a saída, em texto amarelo.

Parâmetros

condition: boolean
Valor Padrão: ""
description: string
Valor Padrão: ""
source: Instance
Valor Padrão: "nil"
line: number
Valor Padrão: 0

Devolução

()

Amostras de código

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

Parâmetros

name: string
Valor Padrão: ""

Devolução

boolean

Run

()
Rendimentos
Segurança do plugin

Executa scripts que são parentados ao TestService.


Devolução

()
Ver todos os herdados de Instance
Ver todos os herdados de Object

Eventos

ServerCollectConditionalResult

Dispedido quando o servidor deve coletar um resultado de teste condicional.

Parâmetros

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

ServerCollectResult

Dispedido quando o servidor deve coletar um resultado de teste.

Parâmetros

text: string
script: Instance
line: number

Ver todos os herdados de Instance
Ver todos os herdados de Object