WaterfallStepContext class

Creates a new WaterfallStepContext instance.

new WaterfallStepContext(dc: DialogContext, info: WaterfallStepInfo<O>)

Parameters

Returns the state information for the dialog on the top of the dialog stack, or undefined if the stack is empty.

DialogInstance | undefined activeDialog

Property Value

Returns dialog context for child if the active dialog is a container.

DialogContext | undefined child

Property Value

Gets the context object for the turn.

public context: TurnContext

Property Value

Returns the current dialog manager instance.

DialogManager dialogManager

Property Value

Gets the dialogs that can be called directly from this context.

public dialogs: DialogSet

Property Value

The index of the current waterfall step being executed.

number index

Property Value

Any options passed to the steps waterfall dialog when it was started with DialogContext.beginDialog().

O options

Property Value

The parent dialog context for this dialog context, or undefined if this context doesn't have a parent.

public parent: DialogContext | undefined

Property Value

Remarks

When it attempts to start a dialog, the dialog context searches for the Dialog.id in its dialogs. If the dialog to start is not found in this dialog context, it searches in its parent dialog context, and so on.

The reason the waterfall step is being executed.

DialogReason reason

Property Value

Results returned by a dialog or prompt that was called in the previous waterfall step.

any result

Property Value

Gets the services collection which is contextual to this dialog context.

public services: TurnContextStateCollection = new TurnContextStateCollection()

Property Value

Gets the current dialog stack.

public stack: DialogInstance[]

Property Value

Gets the DialogStateManager which manages view of all memory scopes.

public state: DialogStateManager

Property Value

A dictionary of values which will be persisted across all waterfall steps.

object values

Property Value

Starts a dialog instance and pushes it onto the dialog stack. Creates a new instance of the dialog and pushes it onto the stack.

function beginDialog(dialogId: string, options?: object)

Parameters

Returns

Remarks

If there's already an active dialog on the stack, that dialog will be paused until it is again the top dialog on the stack.

The status of returned object describes the status of the dialog stack after this method completes.

This method throws an exception if the requested dialog can't be found in this dialog context or any of its ancestors.

For example:

const result = await dc.beginDialog('greeting', { name: user.name });

See also

• endDialog
• prompt
• replaceDialog
• Dialog.beginDialog

Cancels all dialogs on the dialog stack, and clears stack.

function cancelAllDialogs(cancelParents: boolean, eventName?: string, eventValue?: any)

Parameters

Returns

Remarks

This calls each dialog's Dialog.endDialog method before removing the dialog from the stack.

If there were any dialogs on the stack initially, the status of the return value is cancelled; otherwise, it's empty.

This example clears a dialog stack, dc, before starting a 'bookFlight' dialog.

await dc.cancelAllDialogs();
return await dc.beginDialog('bookFlight');

See also

• endDialog

Continues execution of the active dialog, if there is one, by passing this dialog context to its Dialog.continueDialog method.

function continueDialog()

Returns

Remarks

After the call completes, you can check the turn context's responded property to determine if the dialog sent a reply to the user.

The status of returned object describes the status of the dialog stack after this method completes.

Typically, you would call this from within your bot's turn handler.

For example:

const result = await dc.continueDialog();
if (result.status == DialogTurnStatus.empty && dc.context.activity.type == ActivityTypes.message) {
    // Send fallback message
    await dc.context.sendActivity(`I'm sorry. I didn't understand.`);
}

Searches for a dialog with a given ID.

function emitEvent(name: string, value?: any, bubble: boolean, fromLeaf: boolean)

Parameters

Returns

true if the event was handled.

Remarks

Emits a named event for the current dialog, or someone who started it, to handle.

Ends a dialog and pops it off the stack. Returns an optional result to the dialog's parent.

function endDialog(result?: any)

Parameters

Returns

Remarks

The parent dialog is the next dialog on the dialog stack, if there is one. This method calls the parent's Dialog.resumeDialog method, passing the result returned by the ending dialog. If there is no parent dialog, the turn ends and the result is available to the bot through the returned object's result property.

The status of returned object describes the status of the dialog stack after this method completes.

Typically, you would call this from within the logic for a specific dialog to signal back to the dialog context that the dialog has completed, the dialog should be removed from the stack, and the parent dialog should resume.

For example:

return await dc.endDialog(returnValue);

See also

• beginDialog
• replaceDialog
• Dialog.endDialog

Searches for a dialog with a given ID.

function findDialog(dialogId: string)

Parameters

Returns

Remarks

If the dialog to start is not found in the DialogSet associated with this dialog context, it attempts to find the dialog in its parent dialog context.

See also

• dialogs
• parent

Obtain the CultureInfo in DialogContext.

function getLocale()

Returns

a locale string.

Skips to the next waterfall step.

function next(result?: any)

Parameters

Returns

Remarks

return await step.skip();

Helper function to simplify formatting the options for calling a prompt dialog.

function prompt(dialogId: string, promptOrOptions: string | Partial<Activity> | PromptOptions)

Parameters

Returns

Remarks

This helper method formats the object to use as the options parameter, and then calls beginDialog to start the specified prompt dialog.

return await dc.prompt('confirmPrompt', `Are you sure you'd like to quit?`);

Helper function to simplify formatting the options for calling a prompt dialog.

function prompt(dialogId: string, promptOrOptions: string | Partial<Activity> | PromptOptions, choices: string | Choice[])

Parameters

Returns

Remarks

This helper method formats the object to use as the options parameter, and then calls beginDialog to start the specified prompt dialog.

return await dc.prompt('confirmPrompt', `Are you sure you'd like to quit?`);

Ends the active dialog and starts a new dialog in its place.

function replaceDialog(dialogId: string, options?: object)

Parameters

Returns

Remarks

This is particularly useful for creating a loop or redirecting to another dialog.

The status of returned object describes the status of the dialog stack after this method completes.

This method is similar to ending the current dialog and immediately beginning the new one. However, the parent dialog is neither resumed nor otherwise notified.

See also

• beginDialog
• endDialog

Requests the active dialog to re-prompt the user for input.

function repromptDialog()

Returns

Remarks

This calls the active dialog's repromptDialog method.

For example:

await dc.repromptDialog();