Docs Menu

Docs HomeDevelop ApplicationsAtlas Device SDKs

CRUD - Read - React Native SDK

On this page

  • Find a Specific Object by Primary Key
  • Query for an Object Type and Filter Results
  • Query for an Object Type and Sort Results

Read operations are queries to find your data stored in Realm. Data in Realm is live, which means that an object always reflects its most recent saved state and read operations never block. Objects automatically update in response to changes, so you can see up-to-date data in your application without running a new query.

Use the following @realm/react hooks to read data in a realm:

  • useObject(): Find a specific object by primary key.

  • useQuery(): Get a collection of objects by object type.

These hooks return live objects, which are automatically updated when the data in the realm changes. When objects returned by these hooks are updated, the component calling the hook rerenders.

The examples on this page use the following schemas:

If you know the primary key for a given object, you can look it up directly by passing the class type and primary key to the useObject() hook.

In the following example of a TaskItem component, we use the useObject() hook to find a task based on its primary key: _id. Then we render the task's name and priority in the UI.

The useQuery() hook returns a collection of Realm objects that match the query as a Realm.Results object. A basic query matches all objects of a given type in a realm, but you can also apply a filter to the collection to find specific objects.

A filter selects a subset of results based on the value(s) of one or more object properties. Realm lets you filter data using Realm Query Language, a string-based query language to constrain searches when retrieving objects from a realm.

Call filtered() on the query results collection to filter a query. Pass a Realm Query Language query as an argument to filtered().

In the following example of a TaskList component, we:

  1. Obtain all Task objects by passing "Task" to the useQuery() hook.

  2. Obtain all high-priority tasks and low-progress task by passing a query to filtered().

  3. Use the map function to render a list of Text components displaying information about the high-priority and low-progress tasks.

Tip

Filter on Related and Embedded Object Properties

To filter a query based on a property of an embedded object or a related object, use dot-notation as if it were in a regular, nested object.

A sort operation allows you to configure the order in which Realm returns queried objects. You can sort based on one or more properties of the objects in the results collection. Realm only guarantees a consistent order of results if you explicitly sort them.

To sort a query, call the sorted() method on the query results collection.

In the following example of a TaskList component, we use the useQuery() hook to initially retrieve the set of Task objects. We then use the sorted() method to work with the data in various ways:

  1. Sort objects based on the task's name alphabetically.

  2. Sort objects based on the task's name alphabetically in descending order.

  3. Sort objects based on the task's priority in descending order and the task's name in ascending order.

  4. Sort objects based on the assignee object's name alphabetically.

Finally, we map through each list of tasks and render them in the UI.

Tip

Sort on Related and Embedded Object Properties

To sort a query based on a property of an embedded object or a related object, use dot-notation as if it were in a regular, nested object.

← CRUD - Create - React Native SDK