Method connect

packages/nodebox/src/Nodebox.ts:59–124

* Connect to the deployed Node Emulator instance.

()

   * 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(
      'error',
      (event) => {
        frameLoadPromise.reject(event.error);
      },
      { once: true }
    );

    // Wait until the Emulator iframe is ready
    // before communicating with it.
    await frameLoadPromise;

    debug('[message-sender]: IFrame loaded...');

    // Await the worker frame to establish the receiver channel
    // and confirm the functioning message port via handshake.
    await this.channel.handshake();

    debug('[message-sender]: Handshake completed...');

    // Prompt a connection to the worker.
    this.channel.send('connect', {
      cdnUrl,
    });

    this.channel.on('runtime/ready', () => {