upsert

fun <T : Any> upsert(value: T, writeStrategy: DittoWriteStrategy = DittoWriteStrategy.Merge): DittoDocumentId

Inserts a new document into the collection and returns its identifier. If the document already exists, the behavior is determined by the given writeStrategy.

Return

the identifier of the inserted document.

Parameters

value

the value to insert into the collection.

writeStrategy

specifies the desired strategy for inserting a document. The default value is DittoWriteStrategy.Merge.