Expose API method for writing to application side (#4948)

src/browser/TestUtils.test.ts

@@ -72,6 +72,9 @@ export class MockTerminal implements ITerminal {
   public focus(): void {
     throw new Error('Method not implemented.');
   }
+  public input(data: string, wasUserInput: boolean = true): void {
+    throw new Error('Method not implemented.');
+  }
   public resize(columns: number, rows: number): void {
     throw new Error('Method not implemented.');
   }

src/browser/public/Terminal.ts

@@ -138,6 +138,9 @@ export class Terminal extends Disposable implements ITerminalApi {
   public focus(): void {
     this._core.focus();
   }
+  public input(data: string, wasUserInput: boolean = true): void {
+    this._core.input(data, wasUserInput);
+  }
   public resize(columns: number, rows: number): void {
     this._verifyIntegers(columns, rows);
     this._core.resize(columns, rows);

src/common/CoreTerminal.ts

@@ -168,6 +168,19 @@ export abstract class CoreTerminal extends Disposable implements ICoreTerminal {
     this._writeBuffer.writeSync(data, maxSubsequentCalls);
   }
 
+  /**
+   * Input data to application side.
+   * The data is treated the same way as typed input at the terminal.
+   * (will appear in the onData event).
+   * wasUserInput indicates, whether the input is genuine user input.
+   * It is true by default and triggers additional actions like prompt focus or selection clearing.
+   * Set it to false if your data sent does not resemble what a user would have typed
+   * (e.g. sequence embedded data).
+   */
+  public input(data: string, wasUserInput: boolean = true): void {
+    this.coreService.triggerDataEvent(data, wasUserInput);
+  }
+
   public resize(x: number, y: number): void {
     if (isNaN(x) || isNaN(y)) {
       return;

test/playwright/TestUtils.ts

@@ -216,6 +216,7 @@ export class TerminalProxy implements ITerminalProxyCustomMethods, PlaywrightApi
       return new Promise(r => term.writeln(typeof data === 'string' ? data : new Uint8Array(data), r));
     }, [await this.getHandle(), typeof data === 'string' ? data : Array.from(data)] as const);
   }
+  public async input(data: string, wasUserInput: boolean = true): Promise<void> { return this.evaluate(([term]) => term.input(data, wasUserInput)); }
   public async resize(cols: number, rows: number): Promise<void> { return this._page.evaluate(([term, cols, rows]) => term.resize(cols, rows), [await this.getHandle(), cols, rows] as const); }
   public async registerMarker(y?: number | undefined): Promise<IMarker> { return this._page.evaluate(([term, y]) => term.registerMarker(y), [await this.getHandle(), y] as const); }
   public async registerDecoration(decorationOptions: IDecorationOptions): Promise<IDecoration | undefined> { return this._page.evaluate(([term, decorationOptions]) => term.registerDecoration(decorationOptions), [await this.getHandle(), decorationOptions] as const); }

typings/xterm.d.ts

@@ -962,6 +962,16 @@
      * Focus the terminal.
      */
     focus(): void;
+
+    /**
+     * Input data to application side.
+     * The data is treated the same way as typed input at the terminal (will appear in the onData event).
+     * wasUserInput indicates, whether the input is genuine user input.
+     * It is true by default and triggers additional actions like prompt focus or selection clearing.
+     * Set it to false if your data sent does not resemble what a user would have typed
+     * (e.g. sequence embedded data).
+     */
+    input(data: string, wasUserInput?: boolean): void;
 
     /**
      * Resizes the terminal. It's best practice to debounce calls to resize,