TestService

非推奨を表示

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

サービス

テストサービスは、Roblox が内部でエンジンに関する分析テストを実行するために使用するサービスです。ゲーム内で高度なテストを書くことができます。

マクロ

TestService 内で実行されるスクリプト (via TestService:Run() ) は、TestService の下で直接機能を呼び出す特別なマクロにアクセスできます。マクロは、呼び出したいたびに書き直す必要がない大きなコードブロックの置換として本質的に機能します。

RBX_CHECK

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

<th>テスト条件</th>

</tr>



<tr>

  <td>RBX_CHECK(cond)</td>



  <td>cond == 真</td>

</tr>



<tr>

  <td>RBX_CHECK_MESSAGE(cond、失敗Msg)</td>



  <td>cond == 真</td>

</tr>



<tr>

  <td>RBX_CHECK_THROW(コード)</td>



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

</tr>



<tr>

  <td>RBX_CHECK_NO_THROW(コード)</td>



  <td>pcall(function() コードが終了) == 真</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>
マクロ

RBX_REQUIRE

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

<th>テスト条件</th>

</tr>



<tr>

  <td>RBX_REQUIRE(cond)</td>



  <td>cond == 真</td>

</tr>



<tr>

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



  <td>cond == 真</td>

</tr>



<tr>

  <td>RBX_REQUIRE_THROW(コード)</td>



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

</tr>



<tr>

  <td>RBX_REQUIRE_NO_THROW(コード)</td>



  <td>pcall(function() コードが終了) == 真</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>
マクロ

RBX_WARN

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

<th>テスト条件</th>

</tr>



<tr>

  <td>RBX_WARN(cond)</td>



  <td>cond == 真</td>

</tr>



<tr>

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



  <td>cond == 真</td>

</tr>



<tr>

  <td>RBX_WARN_THROW(コード)</td>



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

</tr>



<tr>

  <td>RBX_WARN_NO_THROW(コード)</td>



  <td>pcall(function() コードが終了) == 真</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>
マクロ

追加のマクロ

<th>説明</th>

</tr>



<tr>

  <td>RBX_ERROR(msg)</td>



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

</tr>



<tr>

  <td>RBX_FAIL(msg)</td>



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

</tr>



<tr>

  <td>RBX_MESSAGE(msg)</td>



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

</tr>
マクロ

概要

プロパティ

  • AutoRuns:boolean
    並列読み取り

    真に設定されると、テストサービスの TestService:Run() メソッドが呼ばれるとゲームが実行開始します。

  • Description:string
    並列読み取り

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

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

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

  • ExecuteWithStudioRun:boolean
    並列読み取り

    真に設定されると、Roblox Studio の 実行 アクションを使用するときにテストサービスが実行されます。

  • IsPhysicsEnvironmentalThrottled:boolean
    並列読み取り

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

  • IsSleepAllowed:boolean
    並列読み取り

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

  • NumberOfPlayers:number
    並列読み取り

    このテストで期待されるプレイヤーの数、もしあれば。

  • SimulateSecondsLag:number
    並列読み取り

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

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

    テストセッションに記録されたテスト呼び出しの数を測定します。

  • ThrottlePhysicsToRealtime:boolean
    並列読み取り
  • Timeout:number
    並列読み取り

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

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

    テストセッションに記録された警告通話の数を測定します。

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

方法

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

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

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

    出力に、「テストチェックポイント:」、その後テキストを印刷し、青いテキストです。

  • Done():()

    出力にテストを印刷、青いテキストで。

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

    出力に赤いメッセージを印刷し、TestService: で始まる前に付加します。

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

    テストサービスの実行中に致命的なエラーを示します。これが TestService 内のスクリプト内で呼び出された場合、これはエラーを呼び出した行でブレークポイントを発生させます。

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

    テストメッセージを印刷し、次に出力にテキストを付け、青いテキストです。

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

    条件が説明テキストと一緒に真実かどうかを印刷します。

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

    条件が真の場合は印刷し、そうでない場合は警告を印刷します。

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

    TestService に親属するスクリプトを実行します。

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

イベント

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

プロパティ

AutoRuns

boolean
並列読み取り

真に設定されると、テストサービスの TestService:Run() メソッドが呼ばれるとゲームが実行開始します。

Description

string
並列読み取り

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

ErrorCount

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

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

ExecuteWithStudioRun

boolean
並列読み取り

真に設定されると、Roblox Studio の 実行 アクションを使用するときにテストサービスが実行されます。

注意:

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

IsPhysicsEnvironmentalThrottled

boolean
並列読み取り

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

IsSleepAllowed

boolean
並列読み取り

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

NumberOfPlayers

number
並列読み取り

このテストで期待されるプレイヤーの数、もしあれば。

SimulateSecondsLag

number
並列読み取り

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

TestCount

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

テストセッションに記録されたテスト呼び出しの数を測定します。

ThrottlePhysicsToRealtime

boolean
並列読み取り

Timeout

number
並列読み取り

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

WarnCount

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

テストセッションに記録された警告通話の数を測定します。

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

方法

Check

()

条件が真である場合、「検証がパスされました：」、その後、出力に対する説明を青いテキストで印刷します。そうでないと、「チェック失敗:」を印刷し、再び詳細明を付けますが、赤いテキストです。

パラメータ

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

戻り値

()

コードサンプル

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

()

「テストチェックポイント:」を印刷し、その後 テキスト を出力に青いテキストで付けます。

パラメータ

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

戻り値

()

コードサンプル

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

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



TestService:Checkpoint("example")

Done

()

出力に テスト完了 を青いテキストで印刷する。


戻り値

()

コードサンプル

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

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



TestService:Done()

Error

()

出力に赤いメッセージを印刷し、TestService: で始まる前に付加します。

パラメータ

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

戻り値

()

コードサンプル

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

()

テストサービスの実行中に致命的なエラーを示します。これが TestService 内のスクリプト内で呼び出された場合、これはエラーを呼び出した行でブレークポイントを発生させます。

パラメータ

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

戻り値

()

Message

()

テストメッセージ を印刷し、その後 テキスト を出力に青いテキストで付け加えます。

パラメータ

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

戻り値

()

コードサンプル

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

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



TestService:Message("example")

Require

()

if condition が true である場合、Require passed: を印刷し、その後 description を青いテキストの出力に印刷します。そうでないと、Require failed. Test ended: 、次に description 、赤いテキストの出力に印刷します。

パラメータ

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

戻り値

()

コードサンプル

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

戻り値

Dictionary

Warn

()

条件 が真である場合、警告がパスされました 、次に 説明 、青いテキストで出力に印刷します。そうでない場合、警告: 、続いて 説明 、黄色いテキストで出力に印刷します。

パラメータ

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

戻り値

()

コードサンプル

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

パラメータ

name: string
既定値: ""

戻り値

boolean

Run

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

TestService に親属するスクリプトを実行します。


戻り値

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

イベント

ServerCollectConditionalResult

サーバーが条件付きテスト結果を収集する必要があるときに発射されます。

パラメータ

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

ServerCollectResult

サーバーがテスト結果を収集する必要があるときに発射されます。

パラメータ

text: string
script: Instance
line: number

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