0.1.1 • Public • Published

    Chaosocket Build Status 💣 ⚡️ 💥 🔥 😈

    Create websocket chaos and see how well your app performs DEMO

    The motivation of this project is nothing but being able to receive predefined socket messages. Why this? usually when integrating and testing web sockets in your app it happen that you have no control over the messages you are getting. This leads to slow iterations, like having to test you app against a real source of messages (production) or not doing it at all...

    Chaosocket aims to provide you a set of tools to test this sort of behaviours, also it respects the WebSocket interface, making this transparent to you, this means that you don't have to modify your code at all when you introduce the library in your app. So it's perfect for simple scenarios like what happen when the user name is longer than 50 chars? to complex ones in which you want to stress your UI with 20 messages per second.

    Defining chaos boundaries 📐

    Chaos registration

    const chaos = require('chaosocket');
    chaos.register(() => {
      return {
        type: 'connection',
        user: {
          name: 'Hector'

    Socket usage

    const socket = new WebSocket('ws://');
    socket.onmessage = function(e) {
      const msg = JSON.parse(;
      console.log(msg.type, msg.user);

    Chaosocket will call your message callback by time to time depending in some factors with the result of your registration.


    Sometimes you want to receive more events from a specific type, you achieve that by specifying the frequency of the registration. Default value is medium and the available ones are low, medium and high. Based on it chaosocket will emit events more or less often.

    chaos.register(() => {
      return {
        type: 'connection'
    }, 'low');
    chaos.register(() => {
      return {
        type: 'typing'
    }, 'medium');
    chaos.register(() => {
      return {
        type: 'message'
    }, 'high');


    This will change the default delay (2000ms) to 500ms forcing the app to handle x4 more events.

      delay: 500

    Stop chaos ⛔️

    Tired of chaos? just close it and the socket will stop to recieve fake messages.


    Using Faker 👻

    Chaosocket comes with Faker, a library to generate fake and random data easily, it's passed to the register method.

    chaos.register((faker) => {
      return {
        event_name: faker.random.arrayElement(['connection', 'typing', 'message']),
        bio: faker.lorem.text()

    You can find all Faker methods here

    Demo 🚀

    TODO: Add screenshot

    Installation 🔧

    $ npm i chaosocket -D

    Dependencies 🙇

    Author 👱

    Hector Zarco @zzarcon




    npm i chaosocket

    DownloadsWeekly Downloads






    Last publish


    • zzarcon