t.expect.gt Method

Assertion method. Succeeds if the numeric value of x is greater than the numeric value of y.

t.expect(x).gt(y, message, options) → this | Promise<unknown>
Parameter Type Description
x Number The first operand of the assertion (see the x parameter).
y Any type The second operand of the assertion.
message (optional) String Custom assertion error message.
options (optional) Object See Options.


await t.expect(5).gt(2, '5 is greater than 2');
import { Selector } from 'testcafe';


test('Check width of the element', async t => {
    await t.expect(Selector('#developer-name').clientWidth).gt(100);

the x parameter

x is the first operand of the assertion.

If the first operand contains a selector property, a client function, or any other compatible function, the assertion becomes subject to the Smart Assertion Query Mechanism.

Different assertion methods accept different arguments. Make sure that your operands belong to compatible data types.



Type: Number

If an assertion’s first operand contains a compatible function, the assertion is subject to the Smart Assertion Query Mechanism.

If such an assertion fails, TestCafe executes it again until it meets either of the following criteria:

  • The assertion succeeds.
  • The assertion timeout elapses.
await t.expect(Selector('h1').innerText).eql('text', 'check element text', { timeout: 20000 });

To set the timeout for the entire test run, define the assertion timeout in one of the following ways:


The timeout option applies to built-in TestCafe assertion methods. Use the t.wait() method to specify timeouts for third-party assertion methods (assert or chai).


TestCafe awaits Promises from compatible asynchronous functions. If your assertion includes a custom function that returns a Promise, the assertion fails.

When you create assertions, avoid the use of custom functions that return a Promise. If you can’t work around this limitation, use the allowUnawaitedPromise option:

await t
        .expect(new Promise(resolve => setTimeout(resolve, 100)))
        .ok('received a promise', { allowUnawaitedPromise: true });