kotlin-vscode/vscode/NotebookCellExecution

NotebookCellExecution

interface NotebookCellExecution(source)

A NotebookCellExecution is how notebook controller modify a notebook cell as it is executing.

When a cell execution object is created, the cell enters the NotebookCellExecutionState.Pending state. When start(...)} is called on the execution task, it enters the {@linkcode NotebookCellExecutionState.Executing Executing state. When end(...)} is called, it enters the {@linkcode NotebookCellExecutionState.Idle Idle state.

Online Documentation

Properties

abstract val cell: NotebookCell

The cell for which this execution has been created.

abstract var executionOrder: Int?

Set and unset the order of this cell execution.

abstract val token: CancellationToken

A cancellation token which will be triggered when the cell execution is canceled from the UI.

Functions

abstract fun appendOutput(out: ReadonlyArray<NotebookCellOutput>, cell: NotebookCell = definedExternally): PromiseLike<Void>

abstract fun appendOutput(out: NotebookCellOutput, cell: NotebookCell = definedExternally): PromiseLike<Void>

Append to the output of the cell that is executing or to another cell that is affected by this execution.

appendOutputItems

abstract fun appendOutputItems(items: ReadonlyArray<NotebookCellOutputItem>, output: NotebookCellOutput): PromiseLike<Void>

abstract fun appendOutputItems(items: NotebookCellOutputItem, output: NotebookCellOutput): PromiseLike<Void>

Append output items to existing cell output.

abstract fun clearOutput(cell: NotebookCell = definedExternally): PromiseLike<Void>

Clears the output of the cell that is executing or of another cell that is affected by this execution.

abstract fun end(success: Boolean?, endTime: JsInt53 = definedExternally)

Signal that execution has ended.

abstract fun replaceOutput(out: ReadonlyArray<NotebookCellOutput>, cell: NotebookCell = definedExternally): PromiseLike<Void>

abstract fun replaceOutput(out: NotebookCellOutput, cell: NotebookCell = definedExternally): PromiseLike<Void>

Replace the output of the cell that is executing or of another cell that is affected by this execution.

replaceOutputItems

abstract fun replaceOutputItems(items: ReadonlyArray<NotebookCellOutputItem>, output: NotebookCellOutput): PromiseLike<Void>

abstract fun replaceOutputItems(items: NotebookCellOutputItem, output: NotebookCellOutput): PromiseLike<Void>

Replace all output items of existing cell output.

abstract fun start(startTime: JsInt53 = definedExternally)

Signal that the execution has begun.