fetch
fetch()
executes the specified query and returns an array of entities. For example:
await client.insert('employees', { id: 'Fry', name: 'Philip J. Fry' });
await client.insert('employees', { id: 'Leela', name: 'Turanga Leela' });
const query = client.query('employees').build();
const result = await client.fetch(query, options); // { name: string }[]
Fetch options
Because a Triplit Client may be dealing with two databases (your local database and remote database), the exact nature of how you would like to query those is customizable.
If no options are provided, queries will be fulfilled with the options { policy: 'local-first' }
.
Policy
The policy
option determines how you interact with your local and remote databases.
ℹ️
This is distinct from the syncStatus parameter on a query, which indicates how you wish to query your local database.
The following policy types are valid:
local-first
: (default) This policy will fetch data directly from the local database, however if is determined that the query cannot be fulfilled it will fetch data from the remote database. If the remote database fails to fulfill the query, the cached data is used.local-only
: This policy will fetch data directly from the local database and will never go to the network.remote-first
: This policy will fetch data from the remote database and update the local database with those results before querying the local database.remote-only
: This policy will fetch data directly from the remote database and will not update the local database with results. Results using this policy will also not include any data from the local database - notably any data that has been updated locally but not yet synced. This policy is not available on subscriptions.local-and-remote
: This policy will fetch data from the local database and will fetch results from the remote database in the background and update the local database with those results. Optionally you may provide atimeout
parameter, which informs Triplit to waittimeout
milliseconds for the remote result to update the local database.