Skip to content

@minecraft/server-gametest


@minecraft/server-gametest / GameTestSequence

Class: GameTestSequence

Defined in: @minecraft/server-gametest/index.d.ts:87

Beta

Executes a set of steps defined via chained .thenXyz methods, sequentially. This facilitates a 'script' of GameTest setup methods and assertions over time.

Methods

thenExecute()

thenExecute(callback): GameTestSequence

Defined in: @minecraft/server-gametest/index.d.ts:103

Beta

Parameters

callback

() => void

Callback function to execute.

Returns

GameTestSequence

Returns a GameTestSequence object where additional .thenXyz method steps can be added.

Remarks

Runs the given callback as a step within a GameTest sequence. Exceptions thrown within the callback will end sequence execution.

This function can't be called in read-only mode.


thenExecuteAfter()

thenExecuteAfter(delayTicks, callback): GameTestSequence

Defined in: @minecraft/server-gametest/index.d.ts:120

Beta

Parameters

delayTicks

number

Number of ticks to wait before executing the callback.

callback

() => void

Callback function to execute.

Returns

GameTestSequence

Returns a GameTestSequence object where additional .thenXyz method steps can be added.

Remarks

After a delay, runs the given callback as a step within a GameTest sequence. Exceptions thrown within the callback will end sequence execution.

This function can't be called in read-only mode.


thenExecuteFor()

thenExecuteFor(tickCount, callback): GameTestSequence

Defined in: @minecraft/server-gametest/index.d.ts:134

Beta

Parameters

tickCount

number

callback

() => void

Callback function to execute.

Returns

GameTestSequence

Returns a GameTestSequence object where additional .thenXyz method steps can be added.

Remarks

Runs the given callback every tick for the given number of ticks.

This function can't be called in read-only mode.


thenFail()

thenFail(errorMessage): void

Defined in: @minecraft/server-gametest/index.d.ts:145

Beta

Parameters

errorMessage

string

Error message summarizing the failure condition.

Returns

void

Remarks

Causes the test to fail if this step in the GameTest sequence is reached.

This function can't be called in read-only mode.


thenIdle()

thenIdle(delayTicks): GameTestSequence

Defined in: @minecraft/server-gametest/index.d.ts:159

Beta

Parameters

delayTicks

number

Number of ticks to delay for this step in the GameTest sequence.

Returns

GameTestSequence

Returns a GameTestSequence object where additional .thenXyz method steps can be added.

Remarks

Idles the GameTest sequence for the specified delayTicks.

This function can't be called in read-only mode.


thenSucceed()

thenSucceed(): void

Defined in: @minecraft/server-gametest/index.d.ts:168

Beta

Returns

void

Remarks

Marks the GameTest a success if this step is reached in the GameTest sequence.

This function can't be called in read-only mode.


thenWait()

thenWait(callback): GameTestSequence

Defined in: @minecraft/server-gametest/index.d.ts:184

Beta

Parameters

callback

() => void

Testing callback function to execute. Typically, this function will have .assertXyz functions within it.

Returns

GameTestSequence

Returns a GameTestSequence object where additional .thenXyz method steps can be added.

Remarks

Executes the given callback every tick until it succeeds. Exceptions thrown within the callback will end sequence execution.

This function can't be called in read-only mode.


thenWaitAfter()

thenWaitAfter(delayTicks, callback): GameTestSequence

Defined in: @minecraft/server-gametest/index.d.ts:203

Beta

Parameters

delayTicks

number

Tick (after the previous step in the GameTest sequence) to run the callback at.

callback

() => void

Testing callback function to execute. Typically, this function will have .assertXyz functions within it.

Returns

GameTestSequence

Returns a GameTestSequence object where additional .thenXyz method steps can be added.

Remarks

After a delay from the previous step, executes the given callback every tick until it succeeds. Exceptions thrown within the callback will end sequence execution.

This function can't be called in read-only mode.