Skip to main content
Version: v1

IDeltaConnection Interface

Interface to represent a connection to a delta notification stream.

Signature

export interface IDeltaConnection

Properties

PropertyTypeDescription
connectedboolean

Methods

MethodModifiersReturn TypeDescription
addedGCOutboundReference(srcHandle, outboundHandle)optionalvoidCalled when a new outbound reference is added to another node. This is used by garbage collection to identify all references added in the system.
attach(handler)voidAttaches a message handler to the delta connection
dirty()voidIndicates that the channel is dirty and needs to be part of the summary. It is called by a SharedSummaryBlock that needs to be part of the summary but does not generate ops.
submit(messageContent, localOpMetadata)voidSend new messages to the server.

Property Details

connected

Signature

connected: boolean;

Type: boolean

Method Details

addedGCOutboundReference

Called when a new outbound reference is added to another node. This is used by garbage collection to identify all references added in the system.

Signature

addedGCOutboundReference?(srcHandle: IFluidHandle, outboundHandle: IFluidHandle): void;

Parameters

ParameterTypeDescription
srcHandleIFluidHandleThe handle of the node that added the reference.
outboundHandleIFluidHandleThe handle of the outbound node that is referenced.

attach

Attaches a message handler to the delta connection

Signature

attach(handler: IDeltaHandler): void;

Parameters

ParameterTypeDescription
handlerIDeltaHandler

dirty

Indicates that the channel is dirty and needs to be part of the summary. It is called by a SharedSummaryBlock that needs to be part of the summary but does not generate ops.

Signature

dirty(): void;

submit

Send new messages to the server.

Signature

submit(messageContent: any, localOpMetadata: unknown): void;

Parameters

ParameterTypeDescription
messageContentanyThe content of the message to be sent.
localOpMetadataunknownThe local metadata associated with the message. This is kept locally by the runtime and not sent to the server. It will be provided back when this message is acknowledged by the server. It will also be provided back when asked to resubmit the message.