Interface IFuture<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.

Type Parameters

Hierarchy

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>)

Type declaration

    • (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.

      Returns void | PromiseLike<void>

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

Type declaration

    • (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.

      Parameters

      • msg: REPLY

      Returns void | PromiseLike<void>

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

Type declaration

    • (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.

      Returns void | PromiseLike<void>

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

  • Remove a hook for IOPub messages.

    Parameters

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

      The hook to remove.

      Notes

      If a hook is removed during the hook processing, it will be deactivated immediately.

    Returns void

  • Send an input_reply message.

    Parameters

    Returns void

Generated using TypeDoc