TestService

非推奨を表示

*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

サービス

テストサービスは、Roblox 内部でアナリティックテストを実行するために使用されるサービスです。これにより、ゲーム内で詳細なテストを作成することができます。

マクロ

Class.TestService:Run() 内のスクリプトは、TestService 内の関数を直接呼び出す特殊マクロにアクセスできます。マクロは、コードの大きなブロックを直接呼び出すための汎用のスブスティットです。

RBX_チェック

このマクロは、TestService:Check() 関数を呼び出してテストを実行します。

<tr>

  <td>RBX\_CHECK(コンド)</td>

  <td>cond == はい</td>

</tr>



<tr>

  <td>RBX\_CHECK\_MESSAGE(cond, failMsg)</td>

  <td>cond == はい</td>

</tr>



<tr>

  <td>RBX\_CHECK\_THROW(コード)</td>

  <td>pcall(function() コード終了) が偽です</td>

</tr>



<tr>

  <td>RBX\_CHECK\_NO\_THROW (コード)</td>

  <td>pcall(function() コード終了) が true</td>

</tr>



<tr>

  <td>RBX\_CHECK\_EQUAL(a、b)</td>

  <td>a == b</td>

</tr>



<tr>

  <td>RBX\_CHECK\_NE(a, b)</td>

  <td># 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>
マクロテストコンディション

RBX_要求

このマクロは、TestService:Require() 関数を呼び出してテストします。

<tr>

  <td>RBX\_REQUIRE(コンド)</td>

  <td>cond == はい</td>

</tr>



<tr>

  <td>RBX\_REQUIRE\_メッセージ(cond, failMsg)</td>

  <td>cond == はい</td>

</tr>



<tr>

  <td>RBX\_REQUIRE\_THROW (コード)</td>

  <td>pcall(function() コード終了) が偽です</td>

</tr>



<tr>

  <td>RBX\_REQUIRE\_NO\_THROW (コード)</td>

  <td>pcall(function() コード終了) が true</td>

</tr>



<tr>

  <td>RBX\_REQUIRE\_EQUAL(a, b)</td>

  <td>a == b</td>

</tr>



<tr>

  <td>RBX\_REQUIRE\_NE(a, b)</td>

  <td># 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>
マクロテストコンディション

RBX_ WARN

このマクロは、TestService:Warn() 関数を呼び出してテストを実行します。

<tr>

  <td>RBX\_WARN(cond)</td>

  <td>cond == はい</td>

</tr>



<tr>

  <td>RBX\_WARN\_メッセージ(cond, failMsg)</td>

  <td>cond == はい</td>

</tr>



<tr>

  <td>RBX\_WARN\_THROW (コード)</td>

  <td>pcall(function() コード終了) が偽です</td>

</tr>



<tr>

  <td>RBX\_WARN\_NO\_THROW (コード)</td>

  <td>pcall(function() コード終了) が true</td>

</tr>



<tr>

  <td>RBX\_WARN\_EQUAL(a, b)</td>

  <td>a == b</td>

</tr>



<tr>

  <td>RBX\_WARN\_NE(a, b)</td>

  <td># 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>
マクロテストコンディション

追加のマクロ

<tr>

  <td>RBX\_ERROR(メッセージ)</td>

  <td>直接 <code>Class.TestService:Error()</code> 関数を呼び出します。</td>

</tr>



<tr>

  <td>RBX\_FAIL(メッセージ)</td>

  <td>Class.TestService:Fail() 関数を直接呼び出します。</td>

</tr>



<tr>

  <td>RBX\_メッセージ(msg)</td>

  <td>Class.TestService:Message() 関数を直接呼び出します。</td>

</tr>
マクロ説明

概要

プロパティ

  • AutoRuns:bool
    並列読み取り

    設定が true に設定されている場合、ゲームは TestService:Run() メソッドが呼び出されると開始します。

  • Description:string
    並列読み取り

    テストが実行されている説明。

  • ErrorCount:number
    読み取り専用
    複製されていません
    並列読み取り

    テストセッションに記録されたエラーの数を測定します。

  • ExecuteWithStudioRun:bool
    並列読み取り

    Run アクションを Roblox Studio で使用しているときに、テストサービス が実行されます。

  • Is30FpsThrottleEnabled:bool
    並列読み取り

    テストが実行されている間、物理エンジンが 30 FPS にスロットされるかどうかを設定します。

  • IsPhysicsEnvironmentalThrottled:bool
    並列読み取り

    このテストを実行中に物理環境がスロートされるかどうかを設定します。

  • IsSleepAllowed:bool
    並列読み取り

    テストシミュレーションが実行されている間、物理オブジェクトが眠ることを許可するかどうかを設定します。

  • NumberOfPlayers:number
    並列読み取り

    このテストで期待されているプレイヤーの数、あるいはなし。

  • SimulateSecondsLag:number
    並列読み取り

    テストセッション中にプレイヤーが経験する追加のラテンシーの特定の量を設定します。

  • TestCount:number
    読み取り専用
    複製されていません
    並列読み取り

    テストセッションに記録されたテストコールの数を測定します。

  • Timeout:number
    並列読み取り

    テストが実行できる時間の最大量。

  • WarnCount:number
    読み取り専用
    複製されていません
    並列読み取り

    テストセッションで警告コールが何回記録されたかを測定します。

Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

方法

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

    結果を出力に印刷します。

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

    「テストチェックポイント:」、次にテキストを印刷して、出力、ブルーテキストで表示します。

  • Done():void

    テストが完了したことを出力に印刷します。出力は青いテキストです。

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

    プリント red メッセージを出力に、 TestService: の前にプリフィックスします。

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

    TestService の実行で致命的なエラーが発生しました。これは、スクリプト内のテストサービスを実行しているスクリプト内で呼び出されたエラーです。これがスクリプト内のテストサービスの呼び出し内で呼び出されると、エラーが発生した行のブレークポイントがインターミットされます。

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

    テストメッセージを印刷し、出力にテキストを追加します。

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

    コンディションと説明テキストが真であるかを印刷します。

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

    コンディションが true の場合、警告を打印します。コンディションが false の場合は、警告を打印しません。

  • isFeatureEnabled(name : string):bool
  • Run():void
    イールド
    プラグインのセキュリティ

    TestService に親付けられたスクリプトを実行します。

Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

イベント

Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

プロパティ

AutoRuns

bool
並列読み取り

設定が true に設定されている場合、ゲームは TestService:Run() メソッドが呼び出されると開始します。

Description

string
並列読み取り

テストが実行されている説明。

ErrorCount

number
読み取り専用
複製されていません
並列読み取り

テストセッションに記録されたエラーの数を測定します。

ExecuteWithStudioRun

bool
並列読み取り

Run アクションを Roblox Studio で使用しているときに、テストサービス が実行されます。

注:

  • Class.TestService.NumberOfPlayers プロパティが 0 以上に設定されている場合、ゲームを実行すると、NumberOfPlayers + 1 スタジオウィンドウが開き、1つのウィンドウがサーバーであり、残りは接続されたプレイヤーです。
  • この値を合理的な範囲内に保つことをお勧めします (最大 1人か 8人までのプレイヤー) 、またはコンピュータのCPUがオーバーロードされます。

Is30FpsThrottleEnabled

bool
並列読み取り

テストが実行されている間、物理エンジンが 30 FPS にスロットされるかどうかを設定します。

IsPhysicsEnvironmentalThrottled

bool
並列読み取り

このテストを実行中に物理環境がスロートされるかどうかを設定します。

IsSleepAllowed

bool
並列読み取り

テストシミュレーションが実行されている間、物理オブジェクトが眠ることを許可するかどうかを設定します。

NumberOfPlayers

number
並列読み取り

このテストで期待されているプレイヤーの数、あるいはなし。

SimulateSecondsLag

number
並列読み取り

テストセッション中にプレイヤーが経験する追加のラテンシーの特定の量を設定します。

TestCount

number
読み取り専用
複製されていません
並列読み取り

テストセッションに記録されたテストコールの数を測定します。

Timeout

number
並列読み取り

テストが実行できる時間の最大量。

WarnCount

number
読み取り専用
複製されていません
並列読み取り

テストセッションで警告コールが何回記録されたかを測定します。

Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

方法

Check

void

コンディションが true の場合、「Check passed:」、次に出力の説明を含む、青いテキストで印刷します。そうでない場合は、「Check failed:」、再度、出力の詳細を含む、赤いテキストで印刷します。

パラメータ

condition: bool
description: string
source: Instance
既定値: "nil"
line: number
既定値: 0

戻り値

void

コードサンプル

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



TestService:Check(false, "example")

Checkpoint

void

「テストチェックポイント:」、テキスト 、を含む、出力、青いテキストで印刷します。

パラメータ

text: string
source: Instance
既定値: "nil"
line: number
既定値: 0

戻り値

void

コードサンプル

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



TestService:Checkpoint("example")

Done

void

Prints テスト完了 を出力に、青いテキストで印刷します。


戻り値

void

コードサンプル

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



TestService:Done()

Error

void

プリント red メッセージを出力に、 TestService: の前にプリフィックスします。

パラメータ

description: string
source: Instance
既定値: "nil"
line: number
既定値: 0

戻り値

void

コードサンプル

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



TestService:Error("this is an error")

Fail

void

TestService の実行で致命的なエラーが発生しました。これは、スクリプト内のテストサービスを実行しているスクリプト内で呼び出されたエラーです。これがスクリプト内のテストサービスの呼び出し内で呼び出されると、エラーが発生した行のブレークポイントがインターミットされます。

パラメータ

description: string
source: Instance
既定値: "nil"
line: number
既定値: 0

戻り値

void

Message

void

Prints テストメッセージ 、次に text をテキストとして出力します。

パラメータ

text: string
source: Instance
既定値: "nil"
line: number
既定値: 0

戻り値

void

コードサンプル

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



TestService:Message("example")

Require

void

condition が true の場合、打印は Require passed: 、次に description 、ブルーテキストの出力に続きます。そうでない場合は、打印は 1>require failed. テスト終了: 1> 、次に 4>詳細escription4> 、ブルーテキストの出力に続きます。

パラメータ

condition: bool
description: string
source: Instance
既定値: "nil"
line: number
既定値: 0

戻り値

void

コードサンプル

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



TestService:Require(false, "example")

ScopeTime

Dictionary

戻り値

Dictionary

Warn

void

コンディション が ですか が、打印して 警告 パス 、次に 2> 説明 2> 、出力に 5> 青文 テキスト です 5> 、そうでない場合は 8> 警告 パス 8> 、次に 1> 説明 1> 、出力に 4>

パラメータ

condition: bool
description: string
source: Instance
既定値: "nil"
line: number
既定値: 0

戻り値

void

コードサンプル

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



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

isFeatureEnabled

bool

パラメータ

name: string

戻り値

bool

Run

void
イールド
プラグインのセキュリティ

TestService に親付けられたスクリプトを実行します。


戻り値

void
Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

イベント

ServerCollectConditionalResult

サーバーがコンディショナルテスト結果を集める必要があるときに発動します。

パラメータ

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

ServerCollectResult

サーバーがテスト結果を集める必要があるときに発動します。

パラメータ

text: string
script: Instance
line: number

Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示