phoenix-socket-mock v0.0.3

phoenixMockSocket

• phoenixMockSocket
  • .initialise(url, responsePayloadFunc)
  • .formatPushNotification(topic, eventName, payload)
  • .sendPushNotification(message)

phoenixMockSocket.initialise(url, responsePayloadFunc)

Starts the server socket connection at the url passed, using mock-socket. Provides out of the box handling of the built in phx_join and heartbeat events. Responds to custom incoming messages from the client by applying the result of responsePayloadFunc argument Catches the "A mock server is already listening on this url" from mock-socket and logs a warning, but throws any other errors from mock-socket. This is because your testing framework may attempt to sockets connections to the same URL multiple times during a test run.

Kind: static method of phoenixMockSocket

Example

import phoenixMockSocket from 'phoenix-socket-mock';

function myTest() {
  const url = 'ws://localhost8000/socket/websocket';
  const responsePayloadFunc = (topic, eventName, payload) => {
    let responseString;
    if (payload.message === 'One fish') {
      responseString = 'Two fish';
    } else if (payload.message === 'Red fish') {
      responseString = 'Blue fish';
    } else {
      responseString = 'Unknown fish';
    }
    return {
      response: { message: responseString },
    };
  };
  phoenixMockSocket.initialise(url, responsePayloadFunc);
};

// Client code - this is only given as a reference for the above mock server code
import { Socket } from 'phoenix';

const socket = new Socket('ws://localhost8000/socket/websocket');
socket.connect();

const channel = socket.channel('my_topic');
if (channel.state !== 'joined') {
  channel
    .join()
    .receive('ok', (resp) => {
      console.log('Joined my_topic channel', resp);
    })
    .receive('error', (resp) => {
      console.log('Unable to join my_topic channel', resp);
    });
}
channel.push('my_event_name', {
  message: 'One fish',
});
channel.push('my_event_name', {
  message: 'Red fish',
});
channel.on('my_event_name', (payload) => {
  console.log(payload); // First logs "Two fish", then "Blue fish"
});

phoenixMockSocket.formatPushNotification(topic, eventName, payload)

Formats a push notification to be sent from the server to the client. Note that this is only used for unpromted push notifications from the server to the client, and not for responses to client messages.

Kind: static method of phoenixMockSocket

Example

import phoenixMockSocket from 'phoenix-socket-mock';

const pushNotification = phoenixMockSocket.formatPushNotification('my_topic', 'my_event_name', {
  message: 'This is a push notification from the server'
};

phoenixMockSocket.sendPushNotification(message)

Formats a push notification to be sent from the server to the client. Note that this is only used for unpromted push notifications from the server to the client, and not for responses to client messages.

Kind: static method of phoenixMockSocket

Example

import phoenixMockSocket from 'phoenix-socket-mock';

const pushNotification = phoenixMockSocket.formatPushNotification('my_topic', 'my_event_name', {
  message: 'This is a push notification from the server'
};
phoenixMockSocket.sendPushNotification(pushNotification);