How to test the different hosts

[salmin89]

Step by step instructions for how to test all the different host files.

[guest271314]

There are at least a couple ways to do this

Multiple host files

1. Create an extension for each host.
2. Create an extension where you plan on testing all of the hosts.
3. In each host .json file saved to ~.<chromium,googlechrome>/NativeMessagingHostswrite out the extension ID to the"allowed_originals"` value.
4. Connect to the host from the single extension.

Single host file

1. Create an extension where you plan on testing all of the hosts.
2. Set executable all files you plan on testing.
3. Manually or programmatically change the "path" value in the single host .json file saved to ~.<chromium,googlechrome>/NativeMessagingHosts`.

[salmin89]

Any other ways of testing we can share?

for example:
./hostfile <<< '{"hello": "world"}'

[guest271314]

There's probably a few ways to test both standalone hosts without using the browser for Native Messaging, and testing the hosts as Native Messaging hosts.

[guest271314]

Here is running deno at the command line testing nm_nodejs in this repository.

Chromium passes the file name of the script or compiled program being executed, which should be the same as "path" in the Native Messaging host .json file, and the extension path, chrome-extension://<ID>/, below substituted with native-messaging-extension://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/

$ deno run -A nm_standalone_test.js ./nm_nodejs.js native-messaging-extension://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/
{ messageLength: 1048576 }
[
  null, null, null, null, null, null, null, null, null, null,
  null, null, null, null, null, null, null, null, null, null,
  null, null, null, null, null, null, null, null, null, null,
  null, null, null, null, null, null, null, null, null, null,
  null, null, null, null, null, null, null, null, null, null,
  null, null, null, null, null, null, null, null, null, null,
  null, null, null, null, null, null, null, null, null, null,
  null, null, null, null, null, null, null, null, null, null,
  null, null, null, null, null, null, null, null, null, null,
  null, null, null, null, null, null, null, null, null, null,
  ... 209615 more items
]
{ messageLength: 6 }
test
{ messageLength: 2 }

{ messageLength: 1 }
1
{ messageLength: 8 }
{ "0": 97 }

nm_standalone_test.js

// https://github.com/guest271314/NativeMessagingHosts/discussions/2
// Test Native Messaging host from the command line
// guest271314, 8-1-2024
// deno run -A nm_standalone_test.js ./nm_nodejs.js native-messaging-extension://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/
const [path, allowed_origin] = Deno.args;

const command = new Deno.Command(path, {
  args: [allowed_origin],
  stdout: "piped",
  stdin: "piped",
});

const subprocess = command.spawn();
const buffer = new ArrayBuffer(0, { maxByteLength: 1024 ** 2 });
const view = new DataView(buffer);
const encoder = new TextEncoder();
const decoder = new TextDecoder();

let data;

function encodeMessage(message) {
  return encoder.encode(JSON.stringify(message));
}

async function* getMessage(readable) {
  let messageLength = 0;
  let readOffset = 0;
  for await (let message of readable) {
    if (buffer.byteLength === 0 && messageLength === 0) {
      buffer.resize(4);
      for (let i = 0; i < 4; i++) {
        view.setUint8(i, message[i]);
      }
      messageLength = view.getUint32(0, true);
      console.log({ messageLength });
      message = message.subarray(4);
      buffer.resize(0);
    }

    buffer.resize(buffer.byteLength + message.length);
    for (let i = 0; i < message.length; i++, readOffset++) {
      view.setUint8(readOffset, message[i]);
    }
    if (buffer.byteLength === messageLength) {
      yield new Uint8Array(buffer);
      messageLength = 0;
      readOffset = 0;
      buffer.resize(0);
    }
  }
}

(async () => {
  try {
    for await (const message of getMessage(subprocess.stdout)) {
      console.log(JSON.parse(decoder.decode(message)));
    }
  } catch (e) {
    console.log(e.message);
    Deno.exit();
  }
})();

try {

  data = encodeMessage(Array(209715));

  await new Blob([
    new Uint8Array(new Uint32Array([data.length]).buffer),
    data,
  ])
    .stream()
    .pipeTo(subprocess.stdin, { preventClose: true });

  await new Promise((resolve) => setTimeout(resolve, 20));

  data = encodeMessage("test");
  await new Blob([
    new Uint8Array(new Uint32Array([data.length]).buffer),
    data,
  ])
    .stream()
    .pipeTo(subprocess.stdin, { preventClose: true });

  await new Promise((resolve) => setTimeout(resolve, 200));

  data = encodeMessage("");
  await new Blob([
    new Uint8Array(new Uint32Array([data.length]).buffer),
    data,
  ])
    .stream()
    .pipeTo(subprocess.stdin, { preventClose: true });

  await new Promise((resolve) => setTimeout(resolve, 200));

  data = encodeMessage(1);
  await new Blob([
    new Uint8Array(new Uint32Array([data.length]).buffer),
    data,
  ])
    .stream()
    .pipeTo(subprocess.stdin, { preventClose: true });

  await new Promise((resolve) => setTimeout(resolve, 200));

  data = encodeMessage(new Uint8Array([97]));
  await new Blob([
    new Uint8Array(new Uint32Array([data.length]).buffer),
    data,
  ])
    .stream()
    .pipeTo(subprocess.stdin, { preventClose: true });

  await new Promise((resolve) => setTimeout(resolve, 200));

  Deno.exit(0);
} catch (e) {
  console.log(e.stack);
  Deno.exit(1);
}

nm_standalone_test.js.tar.gz

[salmin89]

Thanks for this! Very helpful. I'll post a nodejs stand-alone tester next week.