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.