Skip to content

Querying data

Read data back the same way you would against commercetools — through the API, using get, withId, withKey or a list query. The mock supports the standard query parameters (where, expand, sort, limit, offset, …).

const result = await apiRoot
.customers()
.get({ queryArgs: { where: 'email = "jane@example.com"', limit: 1 } })
.execute()

where and expand follow the commercetools predicate and reference-expansion syntax.

A few list-query parameters differ from commercetools (sort is ignored, there is no limit ceiling, withTotal is ignored, and where doesn’t error on unknown fields). These and all other known differences are listed on the API coverage & limitations page.

As a convenience you can also read a single resource straight from the test, without going through the SDK, via ctMock.project().get(...):

const customer = await ctMock.project().get('customer', customerId)