get( )

Retrieves an item from a collection.

Description

The get() function returns a Promise that resolves to the item with ID itemId from the specified collection, or null if the itemId is not found. The Promise is rejected if the current user does not have read permissions for the collection.

If the specified collection contains reference fields, the ID of the referenced item is returned. To return the values of the referenced items use query() and include().

Calling the get() function triggers the beforeGet() and afterGet() hooks if they have been defined.

Use the options parameter to run get() from backend code without checking for permissions or without its registered hooks.

Notes:
When using the query() or get() functions or another data retrieval method following a change to your database collection, the data retrieved may not contain your most recent changes. See Wix-data and Eventual Consistency for more information. To solve this problem, you can use the setTimeout() function to delay retrieving data following any changes to your database collection.
An itemId is required to retrieve an item even from a single-item collection.

Syntax

function get(collectionId: string, itemId: string, [options: WixDataOptions]): Promise<Object>

get Parameters

NAME

TYPE

DESCRIPTION

collectionId

string

The ID of the collection to retrieve the item from.

To find your collectionId, select the Databases tab in the Velo Sidebar. Hover over your collection, click the three dots, and select Edit Settings.

itemId

string

The ID of the item to retrieve.

options

Optional

WixDataOptions

An object containing options to use when processing this operation.

Returns

Fulfilled - The retrieved item or null if not found. Rejected - The error that caused the rejection.

Return Type:

Promise<Object>

Was this helpful?

Get an item from a collection

Copy Code

1import wixData from 'wix-data';
2
3// ...
4
5wixData.get("myCollection", "00001")
6  .then((item) => {
7    console.log(item); //see item below
8  })
9  .catch((err) => {
10    console.log(err);
11  });
12
13/*  item is:
14 *
15 *  {
16 *    "_id":          "00001",
17 *    "_owner":       "ffdkj9c2-df8g-f9ke-lk98-4kjhfr89keedb",
18 *    "_createdDate": "2017-05-24T12:33:18.938Z",
19 *    "_updatedDate": "2017-05-24T12:33:18.938Z",
20 *    "title":        "Mr.",
21 *    "first_name":   "John",
22 *    "last_name":    "Doe"
23 *  }
24 */

Get an item from a collection using data options

Copy Code

1import wixData from 'wix-data';
2
3// ...
4
5let options = {
6  "suppressAuth": true,
7  "suppressHooks": true
8};
9
10wixData.get("myCollection", "00001", options)
11  .then((item) => {
12    console.log(item); //see item below
13  })
14  .catch((err) => {
15    console.log(err);
16  });
17
18/*  item is:
19 *
20 *  {
21 *    "_id":          "00001",
22 *    "_owner":       "ffdkj9c2-df8g-f9ke-lk98-4kjhfr89keedb",
23 *    "_createdDate": "2017-05-24T12:33:18.938Z",
24 *    "_updatedDate": "2017-05-24T12:33:18.938Z",
25 *    "title":        "Mr.",
26 *    "first_name":   "John",
27 *    "last_name":    "Doe"
28 *  }
29 */