11 Commits

Author SHA1 Message Date
jwetzell 109a690796 bump @jwetzell/osc version to 1.0.0 2024-10-13 15:31:39 -05:00
jwetzell 548ce61312 fix tests 2024-10-13 15:30:04 -05:00
jwetzell ff57c2c5ee Merge pull request #11 from jwetzell/from-buffer-extra-bytes
fromBuffer methods should return any unprocessed results
2024-10-13 15:22:47 -05:00
jwetzell f47aae936f fromBuffer methods should return any unprocessed results 2024-10-13 15:22:28 -05:00
jwetzell 27585b8f55 Merge pull request #10 from jwetzell/remove-node-buffer
Remove Node Buffer
2024-10-13 15:15:46 -05:00
jwetzell 304158a97e npm run format:write 2024-10-10 17:10:38 -05:00
jwetzell e831c937c8 remove Buffer from bundle tests 2024-10-10 17:10:30 -05:00
jwetzell f1b5227b50 cleanup imports 2024-10-10 17:04:37 -05:00
jwetzell 5875b211f6 remove Buffer from message encode tests 2024-10-10 17:03:49 -05:00
jwetzell 287685a095 remove Buffer from message decode tests 2024-10-10 16:59:44 -05:00
jwetzell 7a07f5d815 remove node Buffer usage from src 2024-10-10 16:45:25 -05:00
10 changed files with 214 additions and 89 deletions
+16 -1
View File
@@ -30,6 +30,11 @@
"makeosc": "src/main.js" "makeosc": "src/main.js"
} }
}, },
"apps/makeosc/node_modules/@jwetzell/osc": {
"version": "0.2.2",
"resolved": "https://registry.npmjs.org/@jwetzell/osc/-/osc-0.2.2.tgz",
"integrity": "sha512-HobCAMnDDSrKfrMBrF5ySA8fKO8Qjkn2HDKysuV51sHrpXABKJFQt5OemIQgbnSMNWU0kZ0+FF9xRrivHHaDTg=="
},
"apps/readosc": { "apps/readosc": {
"version": "0.1.0", "version": "0.1.0",
"license": "MIT", "license": "MIT",
@@ -41,6 +46,11 @@
"readosc": "src/main.js" "readosc": "src/main.js"
} }
}, },
"apps/readosc/node_modules/@jwetzell/osc": {
"version": "0.2.2",
"resolved": "https://registry.npmjs.org/@jwetzell/osc/-/osc-0.2.2.tgz",
"integrity": "sha512-HobCAMnDDSrKfrMBrF5ySA8fKO8Qjkn2HDKysuV51sHrpXABKJFQt5OemIQgbnSMNWU0kZ0+FF9xRrivHHaDTg=="
},
"apps/sendosc": { "apps/sendosc": {
"version": "1.0.1", "version": "1.0.1",
"license": "MIT", "license": "MIT",
@@ -53,6 +63,11 @@
"sendosc": "src/main.js" "sendosc": "src/main.js"
} }
}, },
"apps/sendosc/node_modules/@jwetzell/osc": {
"version": "0.2.2",
"resolved": "https://registry.npmjs.org/@jwetzell/osc/-/osc-0.2.2.tgz",
"integrity": "sha512-HobCAMnDDSrKfrMBrF5ySA8fKO8Qjkn2HDKysuV51sHrpXABKJFQt5OemIQgbnSMNWU0kZ0+FF9xRrivHHaDTg=="
},
"node_modules/@eslint-community/eslint-utils": { "node_modules/@eslint-community/eslint-utils": {
"version": "4.4.0", "version": "4.4.0",
"dev": true, "dev": true,
@@ -3633,7 +3648,7 @@
}, },
"packages/osc": { "packages/osc": {
"name": "@jwetzell/osc", "name": "@jwetzell/osc",
"version": "0.2.2", "version": "1.0.0",
"license": "MIT", "license": "MIT",
"devDependencies": { "devDependencies": {
"@types/node": "22.7.4", "@types/node": "22.7.4",
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "@jwetzell/osc", "name": "@jwetzell/osc",
"version": "0.2.2", "version": "1.0.0",
"description": "", "description": "",
"main": "dist/index.js", "main": "dist/index.js",
"types": "dist/index.d.ts", "types": "dist/index.d.ts",
+31 -13
View File
@@ -2,12 +2,12 @@ import { messageFromBuffer, messageToBuffer } from './message';
import { OSCBundle } from './models'; import { OSCBundle } from './models';
import { oscTypeConverterMap } from './osc-types'; import { oscTypeConverterMap } from './osc-types';
export function bundleFromBuffer(bytes: Buffer): OSCBundle | undefined { export function bundleFromBuffer(bytes: Uint8Array): [OSCBundle | undefined, Uint8Array | undefined] {
if (bytes.length < 8) { if (bytes.length < 8) {
throw new Error('bundle has to be at least 20 bytes'); throw new Error('bundle has to be at least 20 bytes');
} }
if (bytes.subarray(0, 7).toString('ascii') !== '#bundle') { if (new TextDecoder().decode(bytes.subarray(0, 7)) !== '#bundle') {
throw new Error('bundle must start with #bundle'); throw new Error('bundle must start with #bundle');
} }
@@ -33,13 +33,13 @@ export function bundleFromBuffer(bytes: Buffer): OSCBundle | undefined {
if (bundleContentBytes[0] === 35) { if (bundleContentBytes[0] === 35) {
// # character indicating contents is a bundle // # character indicating contents is a bundle
const content = bundleFromBuffer(bundleContentBytes); const [content, bytesAfterContent] = bundleFromBuffer(bundleContentBytes);
if (content) { if (content) {
bundleContents.push(content); bundleContents.push(content);
} }
} else if (bundleContentBytes[0] === 47) { } else if (bundleContentBytes[0] === 47) {
const content = messageFromBuffer(bundleContentBytes); const [content, bytesAfterContent] = messageFromBuffer(bundleContentBytes);
if (content) { if (content && content !== undefined) {
bundleContents.push(content); bundleContents.push(content);
} }
} else { } else {
@@ -51,15 +51,16 @@ export function bundleFromBuffer(bytes: Buffer): OSCBundle | undefined {
endOfBundle = true; endOfBundle = true;
} }
} }
} return [{
return {
timeTag, timeTag,
contents: bundleContents, contents: bundleContents,
}; },remainingBytes];
}
return [undefined, undefined]
} }
export function bundleToBuffer(bundle: OSCBundle): Buffer { export function bundleToBuffer(bundle: OSCBundle): Uint8Array {
const headerBuffer = oscTypeConverterMap.s.toBuffer('#bundle'); const headerBuffer = oscTypeConverterMap.s.toBuffer('#bundle');
if (headerBuffer === undefined) { if (headerBuffer === undefined) {
@@ -72,7 +73,9 @@ export function bundleToBuffer(bundle: OSCBundle): Buffer {
throw new Error('problem encoding buffer time tag'); throw new Error('problem encoding buffer time tag');
} }
const contentsBuffers: Buffer[] = []; const contentsBuffers: Uint8Array[] = [];
let contentsBuffersTotalLength = 0;
bundle.contents.forEach((bundleContent) => { bundle.contents.forEach((bundleContent) => {
if ('address' in bundleContent) { if ('address' in bundleContent) {
@@ -80,10 +83,25 @@ export function bundleToBuffer(bundle: OSCBundle): Buffer {
const contentSizeBuffer = oscTypeConverterMap.i.toBuffer(contentBuffer.length); const contentSizeBuffer = oscTypeConverterMap.i.toBuffer(contentBuffer.length);
if (contentBuffer && contentSizeBuffer) { if (contentBuffer && contentSizeBuffer) {
contentsBuffers.push(Buffer.concat([contentSizeBuffer, contentBuffer])); const buffer = new Uint8Array(contentSizeBuffer.length + contentBuffer.length);
buffer.set(contentSizeBuffer, 0);
buffer.set(contentBuffer, contentSizeBuffer.length);
contentsBuffers.push(buffer);
contentsBuffersTotalLength += buffer.length;
} }
} }
}); });
return Buffer.concat([headerBuffer, timeTagBuffer, ...contentsBuffers]); const buffer = new Uint8Array(headerBuffer.length + timeTagBuffer.length + contentsBuffersTotalLength);
let offset = 0;
buffer.set(headerBuffer, offset);
offset += headerBuffer.length;
buffer.set(timeTagBuffer, offset);
offset += timeTagBuffer.length;
contentsBuffers.forEach((contentBuffer) => {
buffer.set(contentBuffer, offset);
offset += contentBuffer.length;
});
return buffer;
} }
+20 -8
View File
@@ -2,7 +2,8 @@ import { OSCMessage, OSCArg, OSCType } from './models';
import { oscTypeConverterMap } from './osc-types'; import { oscTypeConverterMap } from './osc-types';
function argsToBuffer(args: OSCArg[]) { function argsToBuffer(args: OSCArg[]) {
const argBuffers: Buffer[] = []; const argBuffers: Uint8Array[] = [];
let argBuffersTotalLength = 0;
for (let index = 0; index < args.length; index += 1) { for (let index = 0; index < args.length; index += 1) {
const arg = args[index]; const arg = args[index];
@@ -14,12 +15,19 @@ function argsToBuffer(args: OSCArg[]) {
const buffer = typeConverter.toBuffer(arg.value); const buffer = typeConverter.toBuffer(arg.value);
if (buffer !== undefined) { if (buffer !== undefined) {
argBuffers.push(buffer); argBuffers.push(buffer);
argBuffersTotalLength += buffer.length;
} }
} }
return Buffer.concat(argBuffers); const buffer = new Uint8Array(argBuffersTotalLength);
let offset = 0;
argBuffers.forEach((argBuffer) => {
buffer.set(argBuffer, offset);
offset += argBuffer.length;
});
return buffer;
} }
export function messageToBuffer(message: OSCMessage): Buffer { export function messageToBuffer(message: OSCMessage): Uint8Array {
const addressBuffer = oscTypeConverterMap.s.toBuffer(message.address); const addressBuffer = oscTypeConverterMap.s.toBuffer(message.address);
if (addressBuffer === undefined) { if (addressBuffer === undefined) {
throw new Error('problem encoding address'); throw new Error('problem encoding address');
@@ -31,10 +39,14 @@ export function messageToBuffer(message: OSCMessage): Buffer {
throw new Error('problem encoding types'); throw new Error('problem encoding types');
} }
const argsBuffer = argsToBuffer(message.args); const argsBuffer = argsToBuffer(message.args);
return Buffer.concat([addressBuffer, typesBuffer, argsBuffer]); const buffer = new Uint8Array(addressBuffer.length + typesBuffer.length + argsBuffer.length);
buffer.set(addressBuffer, 0);
buffer.set(typesBuffer, addressBuffer.length);
buffer.set(argsBuffer, addressBuffer.length + typesBuffer.length);
return buffer;
} }
export function messageFromBuffer(bytes: Buffer): OSCMessage | undefined { export function messageFromBuffer(bytes: Uint8Array): [OSCMessage | undefined, Uint8Array | undefined] {
if (bytes[0] !== 47) { if (bytes[0] !== 47) {
throw new Error('osc message must start with a /'); throw new Error('osc message must start with a /');
} }
@@ -66,11 +78,11 @@ export function messageFromBuffer(bytes: Buffer): OSCMessage | undefined {
} }
argsBuffer = remainingBytes; argsBuffer = remainingBytes;
} }
return [{
return {
address, address,
args: oscArgs, args: oscArgs,
}; }, argsBuffer];
} }
} }
return [undefined, undefined]
} }
+3 -3
View File
@@ -1,7 +1,7 @@
export type OSCType = 's' | 'i' | 'f' | 'b' | 'T' | 'F' | 't'; export type OSCType = 's' | 'i' | 'f' | 'b' | 'T' | 'F' | 't';
export type OSCArg = { export type OSCArg = {
type: OSCType; type: OSCType;
value: string | number | Buffer | boolean | OSCTimeTag; value: string | number | Uint8Array | boolean | OSCTimeTag;
}; };
export type OSCTimeTag = [number, number]; export type OSCTimeTag = [number, number];
@@ -17,6 +17,6 @@ export type OSCMessage = {
}; };
export type OSCTypeConverter = { export type OSCTypeConverter = {
toBuffer: (value: string | number | Buffer | boolean | OSCTimeTag) => Buffer | undefined; toBuffer: (value: string | number | Uint8Array | boolean | OSCTimeTag) => Uint8Array | undefined;
fromBuffer: (buffer: Buffer) => [string | number | Buffer | boolean | OSCTimeTag | undefined, Buffer]; fromBuffer: (buffer: Uint8Array) => [string | number | Uint8Array | boolean | OSCTimeTag | undefined, Uint8Array];
}; };
+40 -20
View File
@@ -1,4 +1,4 @@
import { OSCType, OSCArg, OSCMessage, OSCTypeConverter, OSCBundle, OSCTimeTag } from './models'; import { OSCTypeConverter, OSCTimeTag } from './models';
export const oscTypeConverterMap: { [key: string]: OSCTypeConverter } = { export const oscTypeConverterMap: { [key: string]: OSCTypeConverter } = {
s: { s: {
@@ -9,11 +9,11 @@ export const oscTypeConverterMap: { [key: string]: OSCTypeConverter } = {
if (padSize < 4) { if (padSize < 4) {
oscString = oscString.padEnd(oscString.length + padSize, '\u0000'); oscString = oscString.padEnd(oscString.length + padSize, '\u0000');
} }
return Buffer.from(oscString, 'ascii'); return new TextEncoder().encode(oscString);
} }
throw new TypeError('osc type s toBuffer called with non string value'); throw new TypeError('osc type s toBuffer called with non string value');
}, },
fromBuffer: (bytes: Buffer) => { fromBuffer: (bytes) => {
let stringEnd = 0; let stringEnd = 0;
let stringPaddingEnd = 0; let stringPaddingEnd = 0;
for (let index = 0; index < bytes.length; index++) { for (let index = 0; index < bytes.length; index++) {
@@ -29,15 +29,15 @@ export const oscTypeConverterMap: { [key: string]: OSCTypeConverter } = {
} }
} }
return [bytes.toString('ascii', 0, stringEnd), bytes.subarray(stringPaddingEnd)]; return [new TextDecoder().decode(bytes.subarray(0, stringEnd)), bytes.subarray(stringPaddingEnd)];
}, },
}, },
f: { f: {
toBuffer: (number) => { toBuffer: (number) => {
if (typeof number === 'number') { if (typeof number === 'number') {
const buffer = Buffer.alloc(4); const view = new DataView(new ArrayBuffer(4));
buffer.writeFloatBE(number); view.setFloat32(0, number);
return buffer; return new Uint8Array(view.buffer);
} }
throw new TypeError('osc type f toBuffer called with non number value'); throw new TypeError('osc type f toBuffer called with non number value');
}, },
@@ -45,17 +45,22 @@ export const oscTypeConverterMap: { [key: string]: OSCTypeConverter } = {
if (buffer.length < 4) { if (buffer.length < 4) {
throw new Error('not enough bytes to read a osc float'); throw new Error('not enough bytes to read a osc float');
} }
const view = new DataView(new ArrayBuffer(4));
const value = buffer.readFloatBE(); buffer.slice(0, 4).forEach((byte, index) => {
view.setUint8(index, byte);
});
const value = view.getFloat32(0);
return [value, buffer.subarray(4)]; return [value, buffer.subarray(4)];
}, },
}, },
i: { i: {
toBuffer: (number) => { toBuffer: (number) => {
if (typeof number === 'number') { if (typeof number === 'number') {
const buffer = Buffer.alloc(4); const view = new DataView(new ArrayBuffer(4));
buffer.writeInt32BE(number); view.setInt32(0, number);
return buffer; return new Uint8Array(view.buffer);
} }
throw new TypeError('osc type i toBuffer called with non number value'); throw new TypeError('osc type i toBuffer called with non number value');
}, },
@@ -64,21 +69,33 @@ export const oscTypeConverterMap: { [key: string]: OSCTypeConverter } = {
throw new Error('not enough bytes to read a osc integer'); throw new Error('not enough bytes to read a osc integer');
} }
const value = buffer.readInt32BE(); const view = new DataView(new ArrayBuffer(4));
buffer.slice(0, 4).forEach((byte, index) => {
view.setUint8(index, byte);
});
const value = view.getInt32(0);
return [value, buffer.subarray(4)]; return [value, buffer.subarray(4)];
}, },
}, },
b: { b: {
toBuffer: (data) => { toBuffer: (data) => {
if (Buffer.isBuffer(data)) { if (data instanceof Uint8Array) {
const sizeBuffer = oscTypeConverterMap.i.toBuffer(data.length); const sizeBuffer = oscTypeConverterMap.i.toBuffer(data.length);
if (sizeBuffer) { if (sizeBuffer) {
const padSize = 4 - (data.length % 4); let padSize = 4 - (data.length % 4);
const padBuffer = padSize < 4 ? Buffer.from(Array(padSize).fill(0)) : Buffer.from([]); if (padSize === 4) {
return Buffer.concat([sizeBuffer, data, padBuffer]); padSize = 0;
}
const buffer = new Uint8Array(4 + data.length + padSize);
buffer.set(sizeBuffer);
buffer.set(data, 4);
return buffer;
} }
} }
throw new TypeError('osc type b toBuffer called with non Buffer value'); throw new TypeError('osc type b toBuffer called with non Uint8Array value');
}, },
fromBuffer: (buffer) => { fromBuffer: (buffer) => {
const [blobLength, blobBytes] = oscTypeConverterMap.i.fromBuffer(buffer); const [blobLength, blobBytes] = oscTypeConverterMap.i.fromBuffer(buffer);
@@ -97,7 +114,7 @@ export const oscTypeConverterMap: { [key: string]: OSCTypeConverter } = {
}, },
T: { T: {
toBuffer: () => { toBuffer: () => {
return Buffer.alloc(0); return new Uint8Array(0);
}, },
fromBuffer: (buffer) => { fromBuffer: (buffer) => {
return [true, buffer]; return [true, buffer];
@@ -105,7 +122,7 @@ export const oscTypeConverterMap: { [key: string]: OSCTypeConverter } = {
}, },
F: { F: {
toBuffer: () => { toBuffer: () => {
return Buffer.alloc(0); return new Uint8Array(0);
}, },
fromBuffer: (buffer) => { fromBuffer: (buffer) => {
return [false, buffer]; return [false, buffer];
@@ -135,7 +152,10 @@ export const oscTypeConverterMap: { [key: string]: OSCTypeConverter } = {
const fractionalBuffer = oscTypeConverterMap.i.toBuffer(fractional); const fractionalBuffer = oscTypeConverterMap.i.toBuffer(fractional);
if (secondsBuffer && fractionalBuffer) { if (secondsBuffer && fractionalBuffer) {
return Buffer.concat([secondsBuffer, fractionalBuffer]); const buffer = new Uint8Array(8);
buffer.set(secondsBuffer);
buffer.set(fractionalBuffer, 4);
return buffer;
} }
}, },
fromBuffer: (buffer) => { fromBuffer: (buffer) => {
+13 -9
View File
@@ -1,28 +1,32 @@
const { deepEqual } = require('assert'); const { deepEqual, equal } = require('assert');
const { describe, it } = require('node:test'); const { describe, it } = require('node:test');
const osc = require('../dist/index'); const osc = require('../dist/index');
const tests = [ const tests = [
{ {
description: 'simple contents single message', description: 'simple contents single message',
bytes: new Uint8Array([
...new TextEncoder().encode('#bundle'),
...new Uint8Array([0x00]),
...new Uint8Array([0, 0, 0, 32, 0, 0, 0, 0]),
...new Uint8Array([0x00, 0x00, 0x00, 0x20]),
...new Uint8Array([
0x2f, 0x6f, 0x73, 0x63, 0x69, 0x6c, 0x6c, 0x61, 0x74, 0x6f, 0x72, 0x2f, 0x34, 0x2f, 0x66, 0x72, 0x65, 0x71,
0x75, 0x65, 0x6e, 0x63, 0x79, 0x00, 0x2c, 0x66, 0x00, 0x00, 0x43, 0xdc, 0x00, 0x00,
]),
]),
expected: { expected: {
timeTag: [32, 0], timeTag: [32, 0],
contents: [{ address: '/oscillator/4/frequency', args: [{ type: 'f', value: 440 }] }], contents: [{ address: '/oscillator/4/frequency', args: [{ type: 'f', value: 440 }] }],
}, },
bundle: Buffer.concat([
Buffer.from('#bundle', 'ascii'),
Buffer.from([0x00]),
Buffer.from([0, 0, 0, 32, 0, 0, 0, 0]),
Buffer.from('00000020', 'hex'),
Buffer.from('2f6f7363696c6c61746f722f342f6672657175656e6379002c66000043dc0000', 'hex'),
]),
}, },
]; ];
describe('OSC Bundle Decoding', () => { describe('OSC Bundle Decoding', () => {
tests.forEach((bundleTest) => { tests.forEach((bundleTest) => {
it(bundleTest.description, () => { it(bundleTest.description, () => {
const encoded = osc.bundleFromBuffer(bundleTest.bundle); const [encoded, remainingBytes] = osc.bundleFromBuffer(bundleTest.bytes);
equal(remainingBytes.length, 0)
deepEqual(encoded, bundleTest.expected); deepEqual(encoded, bundleTest.expected);
}); });
}); });
+14 -8
View File
@@ -1,17 +1,23 @@
const { deepEqual, throws } = require('assert'); const { deepEqual } = require('assert');
const { describe, it } = require('node:test'); const { describe, it } = require('node:test');
const osc = require('../dist/index'); const osc = require('../dist/index');
const tests = [ const tests = [
{ {
description: 'simple contents single message', description: 'simple contents single message',
bundle: { timeTag: [32, 0], contents: [{ address: '/oscillator/4/frequency', args: [{ type: 'f', value: 440 }] }] }, bundle: {
expected: Buffer.concat([ timeTag: [32, 0],
Buffer.from('#bundle', 'ascii'), contents: [{ address: '/oscillator/4/frequency', args: [{ type: 'f', value: 440 }] }],
Buffer.from([0x00]), },
Buffer.from([0, 0, 0, 32, 0, 0, 0, 0]), expected: new Uint8Array([
Buffer.from('00000020', 'hex'), ...new TextEncoder().encode('#bundle'),
Buffer.from('2f6f7363696c6c61746f722f342f6672657175656e6379002c66000043dc0000', 'hex'), ...new Uint8Array([0x00]),
...new Uint8Array([0, 0, 0, 32, 0, 0, 0, 0]),
...new Uint8Array([0x00, 0x00, 0x00, 0x20]),
...new Uint8Array([
0x2f, 0x6f, 0x73, 0x63, 0x69, 0x6c, 0x6c, 0x61, 0x74, 0x6f, 0x72, 0x2f, 0x34, 0x2f, 0x66, 0x72, 0x65, 0x71,
0x75, 0x65, 0x6e, 0x63, 0x79, 0x00, 0x2c, 0x66, 0x00, 0x00, 0x43, 0xdc, 0x00, 0x00,
]),
]), ]),
}, },
]; ];
+42 -18
View File
@@ -1,51 +1,57 @@
const { deepEqual, throws } = require('assert'); const { deepEqual, throws, equal } = require('assert');
const { describe, it } = require('node:test'); const { describe, it } = require('node:test');
const osc = require('../dist/index'); const osc = require('../dist/index');
const tests = [ const tests = [
{ {
description: 'simple address no args', description: 'simple address no args',
bytes: Buffer.from('2f68656c6c6f00002c000000', 'hex'), bytes: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 0, 0, 0]),
expected: { address: '/hello', args: [] }, expected: { address: '/hello', args: [] },
}, },
{ {
description: 'simple address string arg', description: 'simple address string arg',
bytes: Buffer.from('2f68656c6c6f00002c7300006172673100000000', 'hex'), bytes: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 115, 0, 0, 97, 114, 103, 49, 0, 0, 0, 0]),
expected: { address: '/hello', args: [{ type: 's', value: 'arg1' }] }, expected: { address: '/hello', args: [{ type: 's', value: 'arg1' }] },
}, },
{ {
description: 'simple address integer arg', description: 'simple address integer arg',
bytes: Buffer.from('2f68656c6c6f00002c69000000000023', 'hex'), bytes: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 105, 0, 0, 0, 0, 0, 35]),
expected: { address: '/hello', args: [{ type: 'i', value: 35 }] }, expected: { address: '/hello', args: [{ type: 'i', value: 35 }] },
}, },
{ {
description: 'simple address float arg', description: 'simple address float arg',
bytes: Buffer.from('2f68656c6c6f00002c660000420a0000', 'hex'), bytes: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 102, 0, 0, 66, 10, 0, 0]),
expected: { address: '/hello', args: [{ type: 'f', value: 34.5 }] }, expected: { address: '/hello', args: [{ type: 'f', value: 34.5 }] },
}, },
{ {
description: 'simple address blob arg', description: 'simple address blob arg',
bytes: Buffer.from('2f68656c6c6f00002c62000000000004626c6f62', 'hex'), bytes: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 98, 0, 0, 0, 0, 0, 4, 98, 108, 111, 98]),
expected: { address: '/hello', args: [{ type: 'b', value: Buffer.from('blob') }] }, expected: { address: '/hello', args: [{ type: 'b', value: new TextEncoder().encode('blob') }] },
}, },
{ {
description: 'simple address True arg', description: 'simple address True arg',
bytes: Buffer.from('2f68656c6c6f00002c540000', 'hex'), bytes: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 84, 0, 0]),
expected: { address: '/hello', args: [{ type: 'T', value: true }] }, expected: { address: '/hello', args: [{ type: 'T', value: true }] },
}, },
{ {
description: 'simple address False arg', description: 'simple address False arg',
bytes: Buffer.from('2f68656c6c6f00002c460000', 'hex'), bytes: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 70, 0, 0]),
expected: { address: '/hello', args: [{ type: 'F', value: false }] }, expected: { address: '/hello', args: [{ type: 'F', value: false }] },
}, },
{ {
description: 'osc 1.0 spec example 1', description: 'osc 1.0 spec example 1',
bytes: Buffer.from('2f6f7363696c6c61746f722f342f6672657175656e6379002c66000043dc0000', 'hex'), bytes: 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,
]),
expected: { address: '/oscillator/4/frequency', args: [{ type: 'f', value: 440 }] }, expected: { address: '/oscillator/4/frequency', args: [{ type: 'f', value: 440 }] },
}, },
{ {
description: 'osc 1.0 spec example 2', description: 'osc 1.0 spec example 2',
bytes: Buffer.from('2f666f6f000000002c69697366660000000003e8ffffffff68656c6c6f0000003f9df3b640b5b22d', 'hex'), bytes: 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,
]),
expected: { expected: {
address: '/foo', address: '/foo',
args: [ args: [
@@ -63,7 +69,8 @@ const tests = [
describe('OSC Message Decoding', () => { describe('OSC Message Decoding', () => {
tests.forEach((messageTest) => { tests.forEach((messageTest) => {
it(messageTest.description, () => { it(messageTest.description, () => {
const decoded = osc.messageFromBuffer(messageTest.bytes); const [decoded, remainingBytes] = osc.messageFromBuffer(messageTest.bytes);
equal(remainingBytes.length, 0)
deepEqual(decoded, messageTest.expected); deepEqual(decoded, messageTest.expected);
}); });
}); });
@@ -71,7 +78,9 @@ describe('OSC Message Decoding', () => {
it('bad address', () => { it('bad address', () => {
throws( throws(
() => { () => {
osc.messageFromBuffer(Buffer.from('68656c6c6f00002c660000420a0000', 'hex')); osc.messageFromBuffer(
new Uint8Array([0x68, 0x65, 0x6c, 0x6c, 0x6f, 0x00, 0x00, 0x2c, 0x66, 0x00, 0x00, 0x42, 0x0a, 0x00, 0x00])
);
}, },
{ name: /^Error$/, message: /must start with/ } { name: /^Error$/, message: /must start with/ }
); );
@@ -80,7 +89,9 @@ describe('OSC Message Decoding', () => {
it('bad type string', () => { it('bad type string', () => {
throws( throws(
() => { () => {
osc.messageFromBuffer(Buffer.from('2f68656c6c6f000066000000420a00', 'hex')); osc.messageFromBuffer(
new Uint8Array([0x2f, 0x68, 0x65, 0x6c, 0x6c, 0x6f, 0x00, 0x00, 0x66, 0x00, 0x00, 0x00, 0x42, 0x0a, 0x00])
);
}, },
{ name: /^Error$/, message: /type string must start with/ } { name: /^Error$/, message: /type string must start with/ }
); );
@@ -89,7 +100,11 @@ describe('OSC Message Decoding', () => {
it('unknown type', () => { it('unknown type', () => {
throws( throws(
() => { () => {
osc.messageFromBuffer(Buffer.from('2f68656c6c6f00002c7a0000420a0000', 'hex')); osc.messageFromBuffer(
new Uint8Array([
0x2f, 0x68, 0x65, 0x6c, 0x6c, 0x6f, 0x00, 0x00, 0x2c, 0x7a, 0x00, 0x00, 0x42, 0x0a, 0x00, 0x00,
])
);
}, },
{ name: /^Error$/, message: /unknown/ } { name: /^Error$/, message: /unknown/ }
); );
@@ -98,7 +113,9 @@ describe('OSC Message Decoding', () => {
it('float arg missing bytes', () => { it('float arg missing bytes', () => {
throws( throws(
() => { () => {
osc.messageFromBuffer(Buffer.from('2f68656c6c6f00002c660000420a00', 'hex')); osc.messageFromBuffer(
new Uint8Array([0x2f, 0x68, 0x65, 0x6c, 0x6c, 0x6f, 0x00, 0x00, 0x2c, 0x66, 0x00, 0x00, 0x42, 0x0a, 0x00])
);
}, },
{ name: /^Error$/, message: /not enough bytes/ } { name: /^Error$/, message: /not enough bytes/ }
); );
@@ -107,7 +124,9 @@ describe('OSC Message Decoding', () => {
it('int arg missing bytes', () => { it('int arg missing bytes', () => {
throws( throws(
() => { () => {
osc.messageFromBuffer(Buffer.from('2f68656c6c6f00002c690000000000', 'hex')); osc.messageFromBuffer(
new Uint8Array([0x2f, 0x68, 0x65, 0x6c, 0x6c, 0x6f, 0x00, 0x00, 0x2c, 0x69, 0x00, 0x00, 0x00, 0x00, 0x00])
);
}, },
{ name: /^Error$/, message: /not enough bytes/ } { name: /^Error$/, message: /not enough bytes/ }
); );
@@ -116,7 +135,12 @@ describe('OSC Message Decoding', () => {
it('blob bytes too small', () => { it('blob bytes too small', () => {
throws( throws(
() => { () => {
osc.messageFromBuffer(Buffer.from('2f68656c6c6f00002c62000000000004626c6f', 'hex')); osc.messageFromBuffer(
new Uint8Array([
0x2f, 0x68, 0x65, 0x6c, 0x6c, 0x6f, 0x00, 0x00, 0x2c, 0x62, 0x00, 0x00, 0x00, 0x00, 0x00, 0x04, 0x62, 0x6c,
0x6f,
])
);
}, },
{ name: /^Error$/, message: /not enough bytes/ } { name: /^Error$/, message: /not enough bytes/ }
); );
+34 -8
View File
@@ -6,37 +6,63 @@ const tests = [
{ {
description: 'simple address no args', description: 'simple address no args',
message: { address: '/hello', args: [] }, message: { address: '/hello', args: [] },
expected: Buffer.from('2f68656c6c6f00002c000000', 'hex'), expected: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 0, 0, 0]),
}, },
{ {
description: 'simple address string arg', description: 'simple address string arg',
message: { address: '/hello', args: [{ type: 's', value: 'arg1' }] }, message: { address: '/hello', args: [{ type: 's', value: 'arg1' }] },
expected: Buffer.from('2f68656c6c6f00002c7300006172673100000000', 'hex'), 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', description: 'simple address integer arg',
message: { address: '/hello', args: [{ type: 'i', value: 35 }] }, message: { address: '/hello', args: [{ type: 'i', value: 35 }] },
expected: Buffer.from('2f68656c6c6f00002c69000000000023', 'hex'), expected: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 105, 0, 0, 0, 0, 0, 35]),
}, },
{ {
description: 'simple address float arg', description: 'simple address float arg',
message: { address: '/hello', args: [{ type: 'f', value: 34.5 }] }, message: { address: '/hello', args: [{ type: 'f', value: 34.5 }] },
expected: Buffer.from('2f68656c6c6f00002c660000420a0000', 'hex'), expected: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 102, 0, 0, 66, 10, 0, 0]),
}, },
{ {
description: 'simple address blob arg', description: 'simple address blob arg',
message: { address: '/hello', args: [{ type: 'b', value: Buffer.from('blob') }] }, message: { address: '/hello', args: [{ type: 'b', value: new TextEncoder().encode('blob') }] },
expected: Buffer.from('2f68656c6c6f00002c62000000000004626c6f62', 'hex'), 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', description: 'simple address True arg',
message: { address: '/hello', args: [{ type: 'T', value: true }] }, message: { address: '/hello', args: [{ type: 'T', value: true }] },
expected: Buffer.from('2f68656c6c6f00002c540000', 'hex'), expected: new Uint8Array([47, 104, 101, 108, 108, 111, 0, 0, 44, 84, 0, 0]),
}, },
{ {
description: 'simple address False arg', description: 'simple address False arg',
message: { address: '/hello', args: [{ type: 'F', value: false }] }, message: { address: '/hello', args: [{ type: 'F', value: false }] },
expected: Buffer.from('2f68656c6c6f00002c460000', 'hex'), 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,
]),
}, },
]; ];