Interface IControlFuture<REQUEST, REPLY>

A Future interface for responses from the kernel.

When a message is sent to a kernel, a Future is created to handle any responses that may come from the kernel.

interface IControlFuture<REQUEST, REPLY> {
    done: Promise<REPLY>;
    isDisposed: boolean;
    msg: REQUEST;
    onIOPub: ((msg) => void | PromiseLike<void>);
    onReply: ((msg) => void | PromiseLike<void>);
    onStdin: ((msg) => void | PromiseLike<void>);
    dispose(): void;
    registerMessageHook(hook): void;
    removeMessageHook(hook): void;
    sendInputReply(content, parent_header): void;
}

Type Parameters

Hierarchy (view full)

Properties

done: Promise<REPLY>

A promise that resolves when the future is done.

Notes

The future is done when there are no more responses expected from the kernel.

The done promise resolves to the reply message.

isDisposed: boolean

Test whether the object has been disposed.

Notes

This property is always safe to access.

msg: REQUEST

The original outgoing message.

onIOPub: ((msg) => void | PromiseLike<void>)

The iopub handler for the kernel future.

Notes

If the handler returns a promise, all kernel message processing pauses until the promise is resolved.

Type declaration

onReply: ((msg) => void | PromiseLike<void>)

The reply handler for the kernel future.

Notes

If the handler returns a promise, all kernel message processing pauses until the promise is resolved. If there is a reply message, the future done promise also resolves to the reply message after this handler has been called.

Type declaration

    • (msg): void | PromiseLike<void>
    • Parameters

      Returns void | PromiseLike<void>

onStdin: ((msg) => void | PromiseLike<void>)

The stdin handler for the kernel future.

Notes

If the handler returns a promise, all kernel message processing pauses until the promise is resolved.

Type declaration

Methods

  • Dispose of the resources held by the object.

    Notes

    If the object's dispose method is called more than once, all calls made after the first will be a no-op.

    Undefined Behavior

    It is undefined behavior to use any functionality of the object after it has been disposed unless otherwise explicitly noted.

    Returns void

  • Register hook for IOPub messages.

    Parameters

    • hook: ((msg) => boolean | PromiseLike<boolean>)

      The callback invoked for an IOPub message.

      Notes

      The IOPub hook system allows you to preempt the handlers for IOPub messages handled by the future.

      The most recently registered hook is run first. A hook can return a boolean or a promise to a boolean, in which case all kernel message processing pauses until the promise is fulfilled. If a hook return value resolves to false, any later hooks will not run and the function will return a promise resolving to false. If a hook throws an error, the error is logged to the console and the next hook is run. If a hook is registered during the hook processing, it will not run until the next message. If a hook is removed during the hook processing, it will be deactivated immediately.

    Returns void