t.expect.match Method

Assertion method. Succeeds if x matches the re regular expression.

t.expect(x).match(re, message, options) → this | Promise<unknown>
Parameter Type Description
x String The first operand of the assertion (see the x parameter).
re RegExp Regular expression to test x against.
message (optional) String Custom assertion error message.
options (optional) Object See Options.

Example:

await t.expect('foobar').match(/^f/, 'this assertion will pass');
import { ClientFunction } from 'testcafe';

fixture`TestController.expect.match`
    .page`https://devexpress.github.io/testcafe/example/`;

test('Location should match', async t => {
    const getLocation = ClientFunction(() => document.location.href.toString());

    await t.expect(getLocation()).match(/\.io/);
});

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.

Options

options.timeout

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:

Note

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).

options.allowUnawaitedPromise

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 });