createData()

Create a document in the collection with a data field.

Signature

createData(properties: {*: any}): <Document>

Description

Creates a document in the collection with the provided properties fields and values.

If the following fields are included, they populate the document .data field: id, ts, ttl, and data. Otherwise, the data field isn’t instantiated.

Parameters

Parameter Type Required Description

properties

Object

Yes

Fields to populate the document, including the data field.

properties that populate the .data field

Name Type Required Description

ttl

Time

Timestamp indicating when to remove the document. When the document is removed, it ceases to exist.
Default = null Causes the document to persist indefinitely.

id

Number

User-defined document id.

data

Any

The key:value pairs to populate the data field.

Return value

Type Description

Document

New document with a data field populated with provided properties.

Examples

Create a document with the id and coll metadata fields:

Product.createData({
  id: "12345",
  coll: "Product",
  name: "limes",
  description: "Organic, 2 ct",
  price: 0.65
})
{
  id: "394797306991345728",
  coll: Product,
  ts: Time("2099-04-10T16:35:01.876Z"),
  name: "limes",
  description: "Organic, 2 ct",
  price: 0.65,
  data: {
    coll: "Product",
    id: "12345"
  }
}

createData() treats any metadata field as a document field and nests it in the document’s data property.

Is this article helpful? 

Tell Fauna how the article can be improved:
 Visit Fauna's forums or email docs@fauna.com

Thank you for your feedback!