Class Nodebox

packages/nodebox/src/Nodebox.ts:34–167

 * Create a new Node emulator instance
 */
export class Nodebox {
  private channel: MessageSender = null as any;
  private isConnected: boolean;
  private url: string;

  /* API */
  private fileSystemApi: FileSystemApi = null as any;
  private shellApi: ShellApi = null as any;
  private previewApi: PreviewApi = null as any;

  constructor(private readonly options: ChannelOptions) {
    invariant(
      this.options.iframe,
      'Failed to create a Nodebox: expected "iframe" argument to be a reference to an <iframe> element but got %j',
      this.options.iframe
    );

    this.url = this.options.runtimeUrl || DEFAULT_RUNTIME_URL;

    this.isConnected = false;
  }

  /**
   * Connect to the deployed Node Emulator instance.
   */
  public async connect(): Promise<void> {
    const { iframe, cdnUrl } = this.options;

    debug('[message-sender]: Connecting to node emulator...');

    const connectionPromise = new DeferredPromise<void>();

    if (!this.url) {
      connectionPromise.reject(
        new Error('Nodebox URL is missing. Did you forget to provide it when creating this Nodebox instance?')
      );
    }

    invariant(
      iframe.contentWindow,
      'Failed to create a MessageChannel with the Nodebox iframe: no content window found'
    );

    // Establish a message channel with the worker frame
    // to communicate with the worker instance.
    this.channel = new MessageSender(iframe.contentWindow);

    // Connect to the emulator.
    const frameLoadPromise = new DeferredPromise<void>();
    iframe.setAttribute('src', this.url);
    iframe.addEventListener(
      'load',
      () => {
        frameLoadPromise.resolve();
      },
      { once: true }
    );
    iframe.addEventListener(