document.replaceData()
Replace document data field contents.
Description
The replaceData()
method replaces all data fields with object.
Fields not present in object are removed unless their value is null
.
Examples
Given the following document:
{
id: "392886847463751746",
coll: Product,
ts: Time("2099-04-10T16:50:12.850Z"),
name: "limes",
description: "Conventional, 16 oz bag",
price: 299,
stock: 30,
category: Category("401610017107607625")
}
Call replaceData()
with id
and coll
fields in the replacement document
object. These fields have the same name as reserved
metadata fields.
Product.byId("392886847463751746")?.replaceData({
id: "12345",
coll: "Product",
name: "limes",
description: "Organic, 2 ct",
price: 99,
stock: 50,
category: Category.byId("401610017107607625")
})
{
id: "392886847463751746",
coll: Product,
ts: Time("2099-04-10T17:54:37.670Z"),
name: "limes",
description: "Organic, 2 ct",
price: 99,
stock: 50,
category: Category("401610017107607625"),
data: {
coll: "Product",
id: "12345"
}
}
Rather than return an error, replaceData()
treats any field with a reserved
name 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!