- Since:
- 2.10
Members
(static, readonly) Child :ServerlessDb.EventDescriptor
Creates an event descriptor whose associated subscriptions will raise events as soon as something changes among
the children of the watched data node. The changes to watch on the children nodes must be specified by calling
further one or more of the Addition,
Removal and
Change members on the returned object.
This field creates a new instance of ServerlessDb.EventDescriptor that is intended to be used as
first parameter of the ServerlessDb.ServerlessDbNode#subscribe method.
Type:
(static, readonly) ValueChange :ServerlessDb.EventDescriptor
Creates an event descriptor whose associated subscriptions will raise events as soon as the value of the watched data node changes. The corresponding sent notifications will contain the new value of the data node.
This field creates a new instance of ServerlessDb.EventDescriptor that is intended to be used as
first parameter of the ServerlessDb.ServerlessDbNode#subscribe method.
Type:
(readonly) Addition :ServerlessDb.EventDescriptor
Returns a Child event descriptor updated so that associated subscriptions will raise events as soon as
a new child is added to the watched data node. The corresponding sent notifications will contain the list
of the newly added children as well as their values.
Note: this member is available only on ServerlessDb.EventDescriptor instances created
with the ServerlessDb.EventDescriptor.Child property or one of the
Addition,
Removal and
Change members.
The returned object can be combined further with
Removal and
Change.
Type:
(readonly) Change :ServerlessDb.EventDescriptor
Returns a Child event descriptor updated so that associated subscriptions will raise events as soon as
the value of a child of the watched data node is updated. The corresponding sent notifications will contain
the list of the just updated children as well as their updated values.
Note: this member is available only on ServerlessDb.EventDescriptor instances created
with the ServerlessDb.EventDescriptor.Child property or one of the
Addition,
Removal and
Change members.
The returned object can be combined further with
Addition and
Removal.
Type:
(readonly) isAck :boolean
Property available only on actually raised events, that is, the ones passed to
ServerlessDb.DataSnapshot#event property.
Indicates whether this EventDescriptor only consists in an acknowledgement
of data (the data itself being unchanged).
Type:
- boolean
- Since:
- 3.0
(readonly) isChildAddition :boolean
Returns true if and only if this ServerlessDb.EventDescriptor represents the addition of a new
child on the watched node. It has necessarily been created using
Child and
Addition.
Type:
- boolean
- Since:
- 3.0
(readonly) isChildChange :boolean
Returns true if and only if this ServerlessDb.EventDescriptor represents the change of an
existing child on the watched node. It has necessarily been created using
Child and
Change.
Type:
- boolean
- Since:
- 3.0
(readonly) isChildEvent :boolean
Returns true if and only if this ServerlessDb.EventDescriptor represents an update of one of
the children of the watched node. It has necessarily been created using
Child.
Type:
- boolean
- Since:
- 3.0
(readonly) isChildRemoval :boolean
Returns true if and only if this ServerlessDb.EventDescriptor represents the removal of an
existing child on the watched node. It has necessarily been created using
Child and
Removal.
Type:
- boolean
- Since:
- 3.0
(readonly) isValueChange :boolean
Returns true if and only if this ServerlessDb.EventDescriptor represents a value change of the
watched node.
It has necessarily been created using ValueChange.
Type:
- boolean
- Since:
- 3.0
(readonly) isValueChangeWithoutData :boolean
Returns true if and only if this ServerlessDb.EventDescriptor represents a value change of the
watched node without containing the changed data.
It has necessarily been created using ValueChange and
ValueChange.WithoutData.
Type:
- boolean
- Since:
- 3.0
(readonly) Removal :ServerlessDb.EventDescriptor
Returns a Child event descriptor updated so that associated subscriptions will raise events as soon as
a new child is removed from the watched data node. The corresponding sent notifications will contain the
list of the just removed children.
Note: this member is available only on ServerlessDb.EventDescriptor instances created
with the ServerlessDb.EventDescriptor.Child property or one of the
Addition,
Removal and
Change members.
The returned object can be combined further with
Addition and
Change.
Type:
(readonly) WithoutData :ServerlessDb.EventDescriptor
Creates an event descriptor whose associated subscriptions will raise events as soon as the value of the
watched data node changes, similarly to the ServerlessDb.EventDescriptor.ValueChange field.
However, the corresponding sent notifications will be very lightweight and contain no data.
Note: this member is available only on ServerlessDb.EventDescriptor instances created
with the ServerlessDb.EventDescriptor.ValueChange property.
Type:
Methods
excludeRevocations() → {ServerlessDb.EventDescriptor}
Specifies that the revocations of the subscriptions associated with this
ServerlessDb.EventDescriptor instance will not be watched (and so, will not be notified to the
subscribing targets). Subscriptions are typically revoked as soon as the deadline of the watched event is passed
(see the ServerlessDb.EventDescriptor#until method) or when the security rules forbid to read the
watched data.
Returns:
This EventDescriptor
instance updated.
for(durationSeconds) → {ServerlessDb.EventDescriptor}
Adds a relative deadline timestamp (interpreted relatively to the time when this method is called) to this
ServerlessDb.EventDescriptor instance.
As soon as this deadline is passed, all subscriptions associated with this event descriptor will expire.
Parameters:
| Name | Type | Description |
|---|---|---|
durationSeconds |
number | The duration, expressed in seconds. |
Returns:
This EventDescriptor
instance updated with the specified deadline.
until(dateOrTimestampSeconds) → {ServerlessDb.EventDescriptor}
Adds an absolute deadline timestamp to this ServerlessDb.EventDescriptor instance. As soon as
this deadline is passed, all subscriptions associated with this event descriptor will expire.
Parameters:
| Name | Type | Description |
|---|---|---|
dateOrTimestampSeconds |
number | Date | The deadline. It may be specified as a timestamp in seconds since
Unix Epoch, or as a javascript |
Returns:
This EventDescriptor
instance updated with the specified deadline.