osc-js/packages/osc/tests/message-encode.test.js

const { deepEqual, throws } = require('assert');
const { describe, it } = require('node:test');
const osc = require('../dist/index');

const tests = [
  {
    description: 'simple address no args',
    message: { address: '/hello', args: [] },
    expected: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 0, 0, 0]),
  },
  {
    description: 'simple address string arg',
    message: { address: '/hello', args: [{ type: 's', value: 'arg1' }] },
    expected: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 115, 0, 0, 97, 114, 103, 49, 0, 0, 0, 0]),
  },
  {
    description: 'simple address integer arg',
    message: { address: '/hello', args: [{ type: 'i', value: 35 }] },
    expected: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 105, 0, 0, 0, 0, 0, 35]),
  },
  {
    description: 'simple address float arg',
    message: { address: '/hello', args: [{ type: 'f', value: 34.5 }] },
    expected: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 102, 0, 0, 66, 10, 0, 0]),
  },
  {
    description: 'simple address blob arg',
    message: { address: '/hello', args: [{ type: 'b', value: new TextEncoder().encode('blob') }] },
    expected: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 98, 0, 0, 0, 0, 0, 4, 98, 108, 111, 98]),
  },
  {
    description: 'simple address True arg',
    message: { address: '/hello', args: [{ type: 'T', value: true }] },
    expected: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 84, 0, 0]),
  },
  {
    description: 'simple address False arg',
    message: { address: '/hello', args: [{ type: 'F', value: false }] },
    expected: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 70, 0, 0]),
  },
  {
    description: 'osc 1.0 spec example 1',
    message: { address: '/oscillator/4/frequency', args: [{ type: 'f', value: 440 }] },
    expected: new Uint8Array([
      47, 111, 115, 99, 105, 108, 108, 97, 116, 111, 114, 47, 52, 47, 102, 114, 101, 113, 117, 101, 110, 99, 121, 0, 44,
      102, 0, 0, 67, 220, 0, 0,
    ]),
  },
  {
    description: 'osc 1.0 spec example 2',
    message: {
      address: '/foo',
      args: [
        { type: 'i', value: 1000 },
        { type: 'i', value: -1 },
        { type: 's', value: 'hello' },
        // thanks IEEE 754
        { type: 'f', value: 1.2339999675750732421875 },
        { type: 'f', value: 5.677999973297119140625 },
      ],
    },
    expected: new Uint8Array([
      47, 102, 111, 111, 0, 0, 0, 0, 44, 105, 105, 115, 102, 102, 0, 0, 0, 0, 3, 232, 255, 255, 255, 255, 104, 101, 108,
      108, 111, 0, 0, 0, 63, 157, 243, 182, 64, 181, 178, 45,
    ]),
  },
];

describe('OSC Message Encoding', () => {
  tests.forEach((messageTest) => {
    it(messageTest.description, () => {
      const encoded = osc.messageToBuffer(messageTest.message);
      deepEqual(encoded, messageTest.expected);
    });
  });
  it('bad string arg', () => {
    throws(
      () => {
        osc.messageToBuffer({ address: '/address', args: [{ type: 's', value: 123 }] });
      },
      { name: /^TypeError$/ }
    );
  });

  it('bad integer arg', () => {
    throws(
      () => {
        osc.messageToBuffer({ address: '/address', args: [{ type: 'i', value: 'hi' }] });
      },
      { name: /^TypeError$/ }
    );
  });

  it('bad float arg', () => {
    throws(
      () => {
        osc.messageToBuffer({ address: '/address', args: [{ type: 'f', value: 'hi' }] });
      },
      { name: /^TypeError$/ }
    );
  });

  it('bad blob arg', () => {
    throws(
      () => {
        osc.messageToBuffer({ address: '/address', args: [{ type: 'b', value: 123 }] });
      },
      { name: /^TypeError$/ }
    );
  });

  it('unknown arg type', () => {
    throws(
      () => {
        osc.messageToBuffer({ address: '/address', args: [{ type: 'z', value: 123 }] });
      },
      { name: /^TypeError$/ }
    );
  });
});