How to determine if a Terminal created using new API has been closed by the user?

[DonJayamanne]

• VSCode Version: Insider Build

I'm using the code sample put together by @Tyriar

Steps to Reproduce:

1. Run the above sample
2. Create a terminal using the new API
3. Send text to this new terminal
4. Close the new terminal using the icon on the top right of the terminal panel
   (NOTE: Terminal has now been disposed, but extension is not aware of this)
5. Next try to send text to previously created terminal (that no longer exists)
   A new terminal window is opened.

Is it possible for the extension to be notified of the fact that the terminal has been closed?
Either via:

• A callback (method or event)
• Or extension needs to be able to query this

[Tyriar]

@jrieken what's the common/recommended way of communicating this sort of event via the API?

[jrieken]

We do this with the global events ala window.onDidCloseTerminal like this active editor event.

@Tyriar One question regarding hide vs dispose. Are they the same? So when hiding a terminal its like killing it? Iff so we should revisit the API around that and remove either hide or dispose.

[Tyriar]

@jrieken I should flesh this out in the jsdoc if it wasn't clear, but hide will close the panel if that terminal is currently active, dispose kills the terminal but keeps the panel up.

[jrieken]

Close the new terminal using the icon on the top right of the terminal panel
(NOTE: Terminal has now been disposed, but extension is not aware of this)

@Tyriar I am a little confused because of that. I assume that is the same as calling hide where ctrl+c is like dispose

[Tyriar]

The workbench.action.terminal.kill command (bin icon) will kill the terminal instance, currently the API only goes one way so an API terminal does not know that a terminal has been disposed via the command. I'll look into making an window.onDidCloseTerminal similar to https://github.com/Microsoft/vscode/blob/1f412b5a1e52c661eb60f203fbdc43507430d5df/src/vs/vscode.d.ts#L3321

[DonJayamanne]

@Tyriar , will the proposed window.onDidCloseTerminal be available in the next version (1.5) of VS Code or is this something that would probably be added in a subsequent build?
If it is planned for a later version, then I can work around this without having to wait for it.

[Tyriar]

@DonJayamanne looking at this for 1.6

[DonJayamanne]

@Tyriar , thanks