Function registerWaitForPsesActivationCommand

src/extension.ts:227–265

Registers a command that waits for PSES Activation and returns the PID, used to auto-attach the PSES debugger

(
    context: vscode.ExtensionContext,
)

/** Registers a command that waits for PSES Activation and returns the PID, used to auto-attach the PSES debugger */
function registerWaitForPsesActivationCommand(
    context: vscode.ExtensionContext,
): vscode.Disposable {
    return vscode.commands.registerCommand(
        "PowerShell.WaitForPsesActivationAndReturnProcessId",
        async () => {
            const pidFileName = `PSES-${vscode.env.sessionId}.pid`;
            const pidFile = vscode.Uri.joinPath(
                context.globalStorageUri,
                "sessions",
                pidFileName,
            );
            const fs = vscode.workspace.fs;
            // Wait for the file to be created
            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
            while (true) {
                try {
                    const pidContent = await fs.readFile(pidFile);
                    const pid = parseInt(pidContent.toString(), 10);
                    try {
                        // Check if the process is still alive, delete the PID file if not and continue waiting.
                        // https://nodejs.org/api/process.html#process_process_kill_pid_signal
                        // "As a special case, a signal of 0 can be used to test for the existence of a process. "
                        const NODE_TEST_PROCESS_EXISTENCE = 0;
                        process.kill(pid, NODE_TEST_PROCESS_EXISTENCE);
                    } catch {
                        await fs.delete(pidFile);
                        continue;
                    }
                    // VSCode command returns for launch configurations *must* be string type explicitly, will error on number or otherwise.
                    return pidContent.toString();
                } catch {
                    // File doesn't exist yet, wait and try again
                    await sleep(200);
                }
            }
        },
    );
}

/** Restarts the extension host when extension file changes are detected. Useful for development. */
function restartOnExtensionFileChanges(context: vscode.ExtensionContext): void {