Skip to main content
Version: v2

NotificationsWorkspace Interface

NotificationsWorkspace maintains a registry of NotificationsManagers that facilitate messages across client members in a session.

This API is provided as an alpha preview and may change without notice.

To use, import via @fluidframework/presence/alpha.

For more information about our API support guarantees, see here.

Sealed

This type is "sealed," meaning that code outside of the library defining it should not implement or extend it. Future versions of this type may add members or make typing of readonly members more specific.

Signature​

/** @sealed */
export interface NotificationsWorkspace<TSchema extends Partial<NotificationsWorkspaceSchema<TSchemaKeys>>, TSchemaKeys extends string & keyof TSchema = string & keyof TSchema>

Type Parameters​

ParameterConstraintDefaultDescription
TSchemaPartial<NotificationsWorkspaceSchema<TSchemaKeys>>
TSchemaKeysstring & keyof TSchemastring & keyof TSchema

Properties​

PropertyAlertsModifiersTypeDescription
notificationsAlphareadonlyStatesWorkspaceEntries<TSchema, TSchemaKeys>Registry of NotificationsManagers.
presenceAlphareadonlyPresenceWithNotificationsContaining PresenceWithNotifications

Methods​

MethodAlertsReturn TypeDescription
add(key, manager)Alphaasserts this is NotificationsWorkspace<TSchema & Record<TKey, InternalTypes.ManagerFactory<TKey, TValue, TManager>>>Registers a new NotificationsManager with the NotificationsWorkspace.

Property Details​

notifications​

Registry of NotificationsManagers.

This API is provided as an alpha preview and may change without notice.

For more information about our API support guarantees, see here.

Signature​

readonly notifications: StatesWorkspaceEntries<TSchema, TSchemaKeys>;

Type: StatesWorkspaceEntries<TSchema, TSchemaKeys>

presence​

Containing PresenceWithNotifications

This API is provided as an alpha preview and may change without notice.

For more information about our API support guarantees, see here.

Signature​

readonly presence: PresenceWithNotifications;

Type: PresenceWithNotifications

Method Details​

add​

Registers a new NotificationsManager with the NotificationsWorkspace.

This API is provided as an alpha preview and may change without notice.

For more information about our API support guarantees, see here.

Signature​

add<TKey extends string, TValue extends InternalTypes.ValueDirectoryOrState<unknown>, TManager extends NotificationsManager<InternalUtilityTypes.NotificationListeners<unknown>>>(key: TKey, manager: InternalTypes.ManagerFactory<TKey, TValue, TManager>): asserts this is NotificationsWorkspace<TSchema & Record<TKey, InternalTypes.ManagerFactory<TKey, TValue, TManager>>>;
Type Parameters​
ParameterConstraintDescription
TKeystring
TValueInternalTypes.ValueDirectoryOrState<unknown>
TManagerNotificationsManager<InternalUtilityTypes.NotificationListeners<unknown>>

Parameters​

ParameterTypeDescription
keyTKeynew unique key for the NotificationsManager within the workspace
managerInternalTypes.ManagerFactory<TKey, TValue, TManager>factory for creating a NotificationsManager

Returns​

Return type: asserts this is NotificationsWorkspace<TSchema & Record<TKey, InternalTypes.ManagerFactory<TKey, TValue, TManager>>>