Home Explore Blog CI



docker

content/reference/api/extensions-sdk/ExecStreamOptions.md
cd677fdf965a8732b664cfa09ca41fab46442c7d76ca892d00000003000007f1
---
title: "Interface: ExecStreamOptions"
description: Docker extension API reference
keywords: Docker, extensions, sdk, API, reference
aliases: 
 - /desktop/extensions-sdk/dev/api/reference/interfaces/ExecStreamOptions/
 - /extensions/extensions-sdk/dev/api/reference/interfaces/ExecStreamOptions/
---

**`Since`**

0.2.2

## Properties

### onOutput

• `Optional` **onOutput**: (`data`: { `stdout`: `string` ; `stderr?`: `undefined`  } \| { `stdout?`: `undefined` ; `stderr`: `string`  }) => `void`

#### Type declaration

▸ (`data`): `void`

Invoked when receiving output from command execution.
By default, the output is split into chunks at arbitrary boundaries.
If you prefer the output to be split into complete lines, set `splitOutputLines`
to true. The callback is then invoked once for each line.

**`Since`**

0.2.0

##### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `data` | `{ stdout: string; stderr?: undefined } \| { stdout?: undefined; stderr: string }` | Output content. Can include either stdout string, or stderr string, one at a time. |

##### Returns

`void`

___

### onError

• `Optional` **onError**: (`error`: `any`) => `void`

#### Type declaration

▸ (`error`): `void`

Invoked to report error if the executed command errors.

##### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `error` | `any` | The error happening in the executed command |

##### Returns

`void`

___

### onClose

• `Optional` **onClose**: (`exitCode`: `number`) => `void`

#### Type declaration

▸ (`exitCode`): `void`

Invoked when process exits.

##### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `exitCode` | `number` | The process exit code |

##### Returns

`void`

___

### splitOutputLines

• `Optional` `Readonly` **splitOutputLines**: `boolean`

Specifies the behaviour invoking `onOutput(data)`. Raw output by default, splitting output at any position. If set to true, `onOutput` will be invoked once for each line.

Chunks
3660ab14 (1st chunk of `content/reference/api/extensions-sdk/ExecStreamOptions.md`)
Title: ExecStreamOptions Interface
Summary
The `ExecStreamOptions` interface defines the optional properties for handling the output, errors, and closure of a command execution stream. It includes callbacks for `onOutput` (handling stdout and stderr), `onError` (reporting errors), and `onClose` (handling process exit). It also includes the option `splitOutputLines` to split output into lines.