Index
Constructors
Methods
Constructors
Private constructor
-
Returns FieldValue
Methods
isEqual
-
Returns true if this
FieldValue
is equal to the provided one.Parameters
-
other: FieldValue
The
FieldValue
to compare against.
Returns boolean
true if this
FieldValue
is equal to the provided one. -
Static arrayRemove
-
Returns a special value that can be used with
set()
orupdate()
that tells the server to remove the given elements from any array value that already exists on the server. All instances of each element specified will be removed from the array. If the field being modified is not already an array it will be overwritten with an empty array.Parameters
-
Rest ...elements: any[]
The elements to remove from the array.
Returns FieldValue
The FieldValue sentinel for use in a call to
set()
orupdate()
. -
Static arrayUnion
-
Returns a special value that can be used with
set()
orupdate()
that tells the server to union the given elements with any array value that already exists on the server. Each specified element that doesn't already exist in the array will be added to the end. If the field being modified is not already an array it will be overwritten with an array containing exactly the specified elements.Parameters
-
Rest ...elements: any[]
The elements to union into the array.
Returns FieldValue
The FieldValue sentinel for use in a call to
set()
orupdate()
. -
Static delete
-
Returns a sentinel for use with
update()
to mark a field for deletion.Returns FieldValue
Static increment
-
Returns a special value that can be used with
set()
orupdate()
that tells the server to increment the field's current value by the given value.If either the operand or the current field value uses floating point precision, all arithmetic follows IEEE 754 semantics. If both values are integers, values outside of JavaScript's safe number range (
Number.MIN_SAFE_INTEGER
toNumber.MAX_SAFE_INTEGER
) are also subject to precision loss. Furthermore, once processed by the Firestore backend, all integer operations are capped between -2^63 and 2^63-1.If the current field value is not of type
number
, or if the field does not yet exist, the transformation sets the field to the given value.Parameters
-
n: number
The value to increment by.
Returns FieldValue
The FieldValue sentinel for use in a call to
set()
orupdate()
. -
Static serverTimestamp
-
Returns a sentinel used with
set()
orupdate()
to include a server-generated timestamp in the written data.Returns FieldValue
Sentinel values that can be used when writing document fields with
set()
orupdate()
.