chat: New option to completely disable chat

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ### Notable enhancements and fixes
 
+* New `integratedChat` setting makes it possible to completely disable the
+  built-in chat feature (not just hide it).
 * Improvements to login session management:
   * `express_sid` cookies and `sessionstorage:*` database records are no longer
     created unless `requireAuthentication` is `true` (or a plugin causes them to

doc/docker.md

@@ -80,15 +80,16 @@ The `settings.json.docker` available by default allows to control almost every s
 
 ### General
 
-| Variable           | Description                                                                                | Default                                                                                                                                                                                                                             |
+| Variable           | Description                                                                                                                                                   | Default                                                                                                                                                                                                                             |
-| ------------------ | ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `TITLE`            | The name of the instance                                                                   | `Etherpad`                                                                                                                                                                                                                          |
+| `TITLE`            | The name of the instance                                                                                                                                      | `Etherpad`                                                                                                                                                                                                                          |
-| `FAVICON`          | favicon default name, or a fully specified URL to your own favicon                         | `favicon.ico`                                                                                                                                                                                                                       |
+| `FAVICON`          | favicon default name, or a fully specified URL to your own favicon                                                                                            | `favicon.ico`                                                                                                                                                                                                                       |
-| `DEFAULT_PAD_TEXT` | The default text of a pad                                                                  | `Welcome to Etherpad! This pad text is synchronized as you type, so that everyone viewing this page sees the same text. This allows you to collaborate seamlessly on documents! Get involved with Etherpad at https://etherpad.org` |
+| `DEFAULT_PAD_TEXT` | The default text of a pad                                                                                                                                     | `Welcome to Etherpad! This pad text is synchronized as you type, so that everyone viewing this page sees the same text. This allows you to collaborate seamlessly on documents! Get involved with Etherpad at https://etherpad.org` |
-| `IP`               | IP which etherpad should bind at. Change to `::` for IPv6                                  | `0.0.0.0`                                                                                                                                                                                                                           |
+| `INTEGRATED_CHAT`  | Whether to enable the built-in chat feature. Set this to false if you prefer to use a plugin to provide chat functionality or simply do not want the feature. | true                                                                                                                                                                                                                                |
-| `PORT`             | port which etherpad should bind at                                                         | `9001`                                                                                                                                                                                                                              |
+| `IP`               | IP which etherpad should bind at. Change to `::` for IPv6                                                                                                     | `0.0.0.0`                                                                                                                                                                                                                           |
-| `ADMIN_PASSWORD`   | the password for the `admin` user (leave unspecified if you do not want to create it)      |                                                                                                                                                                                                                                     |
+| `PORT`             | port which etherpad should bind at                                                                                                                            | `9001`                                                                                                                                                                                                                              |
-| `USER_PASSWORD`    | the password for the first user `user` (leave unspecified if you do not want to create it) |                                                                                                                                                                                                                                     |
+| `ADMIN_PASSWORD`   | the password for the `admin` user (leave unspecified if you do not want to create it)                                                                         |                                                                                                                                                                                                                                     |
+| `USER_PASSWORD`    | the password for the first user `user` (leave unspecified if you do not want to create it)                                                                    |                                                                                                                                                                                                                                     |
 
 
 ### Database

settings.json.docker

@@ -223,6 +223,13 @@
    */
   "defaultPadText" : "${DEFAULT_PAD_TEXT:Welcome to Etherpad!\n\nThis pad text is synchronized as you type, so that everyone viewing this page sees the same text. This allows you to collaborate seamlessly on documents!\n\nGet involved with Etherpad at https:\/\/etherpad.org\n}",
 
+  /*
+   * Whether to enable the built-in chat feature. Set this to false if you
+   * prefer to use a plugin to provide chat functionality or simply do not want
+   * the feature.
+   */
+  "integratedChat": "${INTEGRATED_CHAT:true}",
+
   /*
    * Default Pad behavior.
    *
@@ -231,6 +238,7 @@
   "padOptions": {
     "noColors":         "${PAD_OPTIONS_NO_COLORS:false}",
     "showControls":     "${PAD_OPTIONS_SHOW_CONTROLS:true}",
+    // To completely disable chat, set integratedChat to false.
     "showChat":         "${PAD_OPTIONS_SHOW_CHAT:true}",
     "showLineNumbers":  "${PAD_OPTIONS_SHOW_LINE_NUMBERS:true}",
     "useMonospaceFont": "${PAD_OPTIONS_USE_MONOSPACE_FONT:false}",

settings.json.template

@@ -224,6 +224,13 @@
    */
   "defaultPadText" : "Welcome to Etherpad!\n\nThis pad text is synchronized as you type, so that everyone viewing this page sees the same text. This allows you to collaborate seamlessly on documents!\n\nGet involved with Etherpad at https:\/\/etherpad.org\n",
 
+  /*
+   * Whether to enable the built-in chat feature. Set this to false if you
+   * prefer to use a plugin to provide chat functionality or simply do not want
+   * the feature.
+   */
+  "integratedChat": true,
+
   /*
    * Default Pad behavior.
    *
@@ -232,6 +239,7 @@
   "padOptions": {
     "noColors":         false,
     "showControls":     true,
+    // To completely disable chat, set integratedChat to false.
     "showChat":         true,
     "showLineNumbers":  true,
     "useMonospaceFont": false,

src/ep.json

@@ -30,7 +30,12 @@
         "padCheck": "ep_etherpad-lite/node/chat",
         "padCopy": "ep_etherpad-lite/node/chat",
         "padLoad": "ep_etherpad-lite/node/chat",
-        "padRemove": "ep_etherpad-lite/node/chat",
+        "padRemove": "ep_etherpad-lite/node/chat"
+      }
+    },
+    {
+      "name": "chatAlwaysLoaded",
+      "hooks": {
         "socketio": "ep_etherpad-lite/node/chat"
       }
     },

src/node/chat.js

@@ -10,10 +10,14 @@ const hooks = require('../static/js/pluginfw/hooks.js');
 const pad = require('./db/Pad');
 const padManager = require('./db/PadManager');
 const padMessageHandler = require('./handler/PadMessageHandler');
+const settings = require('./utils/Settings');
 
 let socketio;
 
 const appendChatMessage = async (pad, msg) => {
+  if (!settings.integratedChat) {
+    throw new Error('integrated chat is disabled (see integratedChat in settings.json)');
+  }
   pad.chatHead++;
   await Promise.all([
     // Don't save the display name in the database because the user can change it at any time. The
@@ -25,6 +29,9 @@ const appendChatMessage = async (pad, msg) => {
 };
 
 const getChatMessage = async (pad, entryNum) => {
+  if (!settings.integratedChat) {
+    throw new Error('integrated chat is disabled (see integratedChat in settings.json)');
+  }
   const entry = await pad.db.get(`pad:${pad.id}:chat:${entryNum}`);
   if (entry == null) return null;
   const message = ChatMessage.fromObject(entry);
@@ -33,6 +40,9 @@ const getChatMessage = async (pad, entryNum) => {
 };
 
 const getChatMessages = async (pad, start, end) => {
+  if (!settings.integratedChat) {
+    throw new Error('integrated chat is disabled (see integratedChat in settings.json)');
+  }
   const entries = await Promise.all(
       [...Array(end + 1 - start).keys()].map((i) => getChatMessage(pad, start + i)));
 
@@ -49,6 +59,9 @@ const getChatMessages = async (pad, start, end) => {
 };
 
 const sendChatMessageToPadClients = async (message, padId) => {
+  if (!settings.integratedChat) {
+    throw new Error('integrated chat is disabled (see integratedChat in settings.json)');
+  }
   const pad = await padManager.getPad(padId, null, message.authorId);
   await hooks.aCallAll('chatNewMessage', {message, pad, padId});
   // appendChatMessage() ignores the displayName property so we don't need to wait for
@@ -65,6 +78,7 @@ const sendChatMessageToPadClients = async (message, padId) => {
 exports.clientVars = (hookName, {pad: {chatHead}}) => ({chatHead});
 
 exports.eejsBlock_mySettings = (hookName, context) => {
+  if (!settings.integratedChat) return;
   context.content += `
     <p class="hide-for-mobile">
       <input type="checkbox" id="options-stickychat">
@@ -78,6 +92,7 @@ exports.eejsBlock_mySettings = (hookName, context) => {
 };
 
 exports.eejsBlock_stickyContainer = (hookName, context) => {
+  if (!settings.integratedChat) return;
   /* eslint-disable max-len */
   context.content += `
     <div id="chaticon" class="visible" title="Chat (Alt C)">
@@ -123,6 +138,7 @@ exports.exportEtherpad = async (hookName, {pad, data, dstPadId}) => {
 };
 
 exports.handleMessage = async (hookName, {message, sessionInfo, socket}) => {
+  if (!settings.integratedChat) return;
   const {authorId, padId, readOnly} = sessionInfo;
   if (message.type !== 'COLLABROOM' || readOnly) return;
   switch (message.data.type) {
@@ -233,6 +249,9 @@ api.registerChatHandlers({
    * {code: 1, message:"padID does not exist", data: null}
    */
   appendChatMessage: async (padId, text, authorId, time) => {
+    if (!settings.integratedChat) {
+      throw new Error('integrated chat is disabled (see integratedChat in settings.json)');
+    }
     if (typeof text !== 'string') throw new CustomError('text is not a string', 'apierror');
     if (time === undefined || !Number.isInteger(Number.parseFloat(time))) time = Date.now();
     await sendChatMessageToPadClients(new ChatMessage(text, authorId, time), padId);
@@ -247,6 +266,9 @@ api.registerChatHandlers({
    * {code: 1, message:"padID does not exist", data: null}
    */
   getChatHead: async (padId) => {
+    if (!settings.integratedChat) {
+      throw new Error('integrated chat is disabled (see integratedChat in settings.json)');
+    }
     const pad = await getPadSafe(padId);
     const {chatHead = -1} = pad;
     return {chatHead};
@@ -267,6 +289,9 @@ api.registerChatHandlers({
    * {code: 1, message:"padID does not exist", data: null}
    */
   getChatHistory: async (padId, start, end) => {
+    if (!settings.integratedChat) {
+      throw new Error('integrated chat is disabled (see integratedChat in settings.json)');
+    }
     if (start && end) {
       if (start < 0) throw new CustomError('start is below zero', 'apierror');
       if (end < 0) throw new CustomError('end is below zero', 'apierror');

src/node/hooks/express/static.js

@@ -28,11 +28,13 @@ const tar = (() => {
       'pad_impexp.js',
       'pad_savedrevs.js',
       'pad_connectionstatus.js',
-      'ChatMessage.js',
+      ...settings.integratedChat ? [
-      'chat.js',
+        'ChatMessage.js',
+        'chat.js',
+        '$tinycon/tinycon.js',
+      ] : [],
       'vendors/gritter.js',
       '$js-cookie/dist/js.cookie.js',
-      '$tinycon/tinycon.js',
       'vendors/farbtastic.js',
       'skin_variants.js',
       'socketio.js',

src/node/hooks/express/tests.js

@@ -38,8 +38,10 @@ exports.expressPreSession = async (hookName, {app}) => {
         if (!pluginPath.endsWith(path.sep)) pluginPath += path.sep;
         const specDir = `${plugin === 'ep_etherpad-lite' ? '' : 'static/'}tests/frontend/specs`;
         for (const spec of await findSpecs(path.join(pluginPath, specDir))) {
-          if (plugin === 'ep_etherpad-lite' && !settings.enableAdminUITests &&
+          if (plugin === 'ep_etherpad-lite') {
-              spec.startsWith('admin')) continue;
+            if (!settings.enableAdminUITests && spec.startsWith('admin')) continue;
+            if (!settings.integratedChat && spec.startsWith('chat')) continue;
+          }
           modules.push(`${plugin}/${specDir}/${spec.replace(/\.js$/, '')}`);
         }
       }));

src/node/utils/Minify.js

@@ -42,7 +42,7 @@ const LIBRARY_WHITELIST = [
   'js-cookie',
   'security',
   'split-grid',
-  'tinycon',
+  ...settings.integratedChat ? ['tinycon'] : [],
   'underscore',
   'unorm',
 ];

src/node/utils/Settings.js

@@ -156,6 +156,12 @@ exports.defaultPadText = [
   'Etherpad on Github: https://github.com/ether/etherpad-lite',
 ].join('\n');
 
+/**
+ * Whether to enable the built-in chat feature. Set this to false if you prefer to use a plugin to
+ * provide chat functionality or simply do not want the feature.
+ */
+exports.integratedChat = true;
+
 /**
  * The default Pad Settings for a user (Can be overridden by changing the setting
  */

src/static/js/pluginfw/plugins.js

@@ -5,6 +5,7 @@ const hooks = require('./hooks');
 const log4js = require('log4js');
 const path = require('path');
 const runCmd = require('../../../node/utils/run_cmd');
+const settings = require('../../../node/utils/Settings');
 const tsort = require('./tsort');
 const pluginUtils = require('./shared');
 const defs = require('./plugin_defs');
@@ -136,6 +137,9 @@ const loadPlugin = async (packages, pluginName, plugins, parts) => {
     const data = await fs.readFile(pluginPath);
     try {
       const plugin = JSON.parse(data);
+      if (pluginName === 'ep_etherpad-lite' && !settings.integratedChat) {
+        plugin.parts = plugin.parts.filter((part) => part.name !== 'chat');
+      }
       plugin.package = packages[pluginName];
       plugins[pluginName] = plugin;
       for (const part of plugin.parts) {

src/tests/backend/specs/api/chat.js

@@ -2,6 +2,8 @@
 
 const assert = require('assert').strict;
 const common = require('../../common');
+const plugins = require('../../../../static/js/pluginfw/plugins');
+const settings = require('../../../../node/utils/Settings');
 
 let agent;
 const apiKey = common.apiKey;
@@ -13,7 +15,12 @@ const timestamp = Date.now();
 const endPoint = (point) => `/api/${apiVersion}/${point}?apikey=${apiKey}`;
 
 describe(__filename, function () {
+  const backups = {settings: {}};
+
   before(async function () {
+    backups.settings.integratedChat = settings.integratedChat;
+    settings.integratedChat = true;
+    await plugins.update();
     agent = await common.init();
     await agent.get('/api/')
         .expect(200)
@@ -37,7 +44,16 @@ describe(__filename, function () {
         });
   });
 
-  describe('message sequence', function () {
+  after(async function () {
+    Object.assign(settings, backups.settings);
+    await plugins.update();
+  });
+
+  describe('settings.integratedChat = true', function () {
+    beforeEach(async function () {
+      settings.integratedChat = true;
+    });
+
     it('appendChatMessage', async function () {
       await agent.get(`${endPoint('appendChatMessage')}&padID=${padID}&text=blalblalbha` +
                 `&authorID=${authorID}&time=${timestamp}`)
@@ -68,6 +84,40 @@ describe(__filename, function () {
           });
     });
   });
+
+  describe('settings.integratedChat = false', function () {
+    beforeEach(async function () {
+      settings.integratedChat = false;
+    });
+
+    it('appendChatMessage returns an error', async function () {
+      await agent.get(`${endPoint('appendChatMessage')}&padID=${padID}&text=blalblalbha` +
+                `&authorID=${authorID}&time=${timestamp}`)
+          .expect(500)
+          .expect('Content-Type', /json/)
+          .expect((res) => {
+            assert.equal(res.body.code, 2);
+          });
+    });
+
+    it('getChatHead returns an error', async function () {
+      await agent.get(`${endPoint('getChatHead')}&padID=${padID}`)
+          .expect(500)
+          .expect('Content-Type', /json/)
+          .expect((res) => {
+            assert.equal(res.body.code, 2);
+          });
+    });
+
+    it('getChatHistory returns an error', async function () {
+      await agent.get(`${endPoint('getChatHistory')}&padID=${padID}`)
+          .expect(500)
+          .expect('Content-Type', /json/)
+          .expect((res) => {
+            assert.equal(res.body.code, 2);
+          });
+    });
+  });
 });
 
 function makeid() {

src/tests/backend/specs/chat.js

@@ -6,29 +6,37 @@ const assert = require('assert').strict;
 const common = require('../common');
 const padManager = require('../../../node/db/PadManager');
 const pluginDefs = require('../../../static/js/pluginfw/plugin_defs');
+const plugins = require('../../../static/js/pluginfw/plugins');
+const settings = require('../../../node/utils/Settings');
 
 const logger = common.logger;
 
 const checkHook = async (hookName, checkFn) => {
   if (pluginDefs.hooks[hookName] == null) pluginDefs.hooks[hookName] = [];
-  await new Promise((resolve, reject) => {
+  let hook;
-    pluginDefs.hooks[hookName].push({
+  try {
-      hook_fn: async (hookName, context) => {
+    await new Promise((resolve, reject) => {
-        if (checkFn == null) return;
+      hook = {
-        logger.debug(`hook ${hookName} invoked`);
+        hook_fn: async (hookName, context) => {
-        try {
+          if (checkFn == null) return;
-          // Make sure checkFn is called only once.
+          logger.debug(`hook ${hookName} invoked`);
-          const _checkFn = checkFn;
+          try {
-          checkFn = null;
+            // Make sure checkFn is called only once.
-          await _checkFn(context);
+            const _checkFn = checkFn;
-        } catch (err) {
+            checkFn = null;
-          reject(err);
+            await _checkFn(context);
-          return;
+          } catch (err) {
-        }
+            reject(err);
-        resolve();
+            return;
-      },
+          }
+          resolve();
+        },
+      };
+      pluginDefs.hooks[hookName].push(hook);
     });
-  });
+  } finally {
+    pluginDefs.hooks[hookName] = pluginDefs.hooks[hookName].filter((h) => h !== hook);
+  }
 };
 
 const sendMessage = async (socket, data) => (
@@ -37,119 +45,146 @@ const sendChat = async (socket, message) => (
   await sendMessage(socket, {type: 'CHAT_MESSAGE', message}));
 
 describe(__filename, function () {
+  const backups = {settings: {}};
+  let clientVars;
   const padId = 'testChatPad';
-  const hooksBackup = {};
+  let socket;
+
+  const connect = async () => {
+    socket = await common.connect();
+    ({data: clientVars} = await common.handshake(socket, padId));
+  };
 
   before(async function () {
-    for (const [name, defs] of Object.entries(pluginDefs.hooks)) {
+    backups.settings.integratedChat = settings.integratedChat;
-      if (defs == null) continue;
-      hooksBackup[name] = defs;
-    }
   });
 
   beforeEach(async function () {
-    for (const [name, defs] of Object.entries(hooksBackup)) pluginDefs.hooks[name] = [...defs];
-    for (const name of Object.keys(pluginDefs.hooks)) {
-      if (hooksBackup[name] == null) delete pluginDefs.hooks[name];
-    }
     if (await padManager.doesPadExist(padId)) {
       const pad = await padManager.getPad(padId);
       await pad.remove();
     }
   });
 
-  after(async function () {
+  afterEach(async function () {
-    Object.assign(pluginDefs.hooks, hooksBackup);
+    if (socket) {
-    for (const name of Object.keys(pluginDefs.hooks)) {
+      socket.close();
-      if (hooksBackup[name] == null) delete pluginDefs.hooks[name];
+      socket = null;
     }
   });
 
-  describe('chatNewMessage hook', function () {
+  after(async function () {
-    let authorId;
+    Object.assign(settings, backups.settings);
-    let socket;
+    await plugins.update();
+  });
+
+  describe('settings.integratedChat = true', function () {
+    before(async function () {
+      settings.integratedChat = true;
+      await plugins.update();
+    });
 
     beforeEach(async function () {
-      socket = await common.connect();
+      await connect();
-      const {data: clientVars} = await common.handshake(socket, padId);
-      authorId = clientVars.userId;
     });
 
-    afterEach(async function () {
+    describe('chatNewMessage hook', function () {
-      socket.close();
+      it('message', async function () {
-    });
+        const start = Date.now();
-
+        await Promise.all([
-    it('message', async function () {
+          checkHook('chatNewMessage', ({message}) => {
-      const start = Date.now();
+            assert(message != null);
-      await Promise.all([
+            assert(message instanceof ChatMessage);
-        checkHook('chatNewMessage', ({message}) => {
+            assert.equal(message.authorId, clientVars.userId);
-          assert(message != null);
+            assert.equal(message.text, this.test.title);
-          assert(message instanceof ChatMessage);
+            assert(message.time >= start);
-          assert.equal(message.authorId, authorId);
+            assert(message.time <= Date.now());
-          assert.equal(message.text, this.test.title);
+          }),
-          assert(message.time >= start);
+          sendChat(socket, {text: this.test.title}),
-          assert(message.time <= Date.now());
+        ]);
-        }),
-        sendChat(socket, {text: this.test.title}),
-      ]);
-    });
-
-    it('pad', async function () {
-      await Promise.all([
-        checkHook('chatNewMessage', ({pad}) => {
-          assert(pad != null);
-          assert(pad instanceof Pad);
-          assert.equal(pad.id, padId);
-        }),
-        sendChat(socket, {text: this.test.title}),
-      ]);
-    });
-
-    it('padId', async function () {
-      await Promise.all([
-        checkHook('chatNewMessage', (context) => {
-          assert.equal(context.padId, padId);
-        }),
-        sendChat(socket, {text: this.test.title}),
-      ]);
-    });
-
-    it('mutations propagate', async function () {
-      const listen = async (type) => await new Promise((resolve) => {
-        const handler = (msg) => {
-          if (msg.type !== 'COLLABROOM') return;
-          if (msg.data == null || msg.data.type !== type) return;
-          resolve(msg.data);
-          socket.off('message', handler);
-        };
-        socket.on('message', handler);
       });
 
-      const modifiedText = `${this.test.title} <added changes>`;
+      it('pad', async function () {
-      const customMetadata = {foo: this.test.title};
+        await Promise.all([
-      await Promise.all([
+          checkHook('chatNewMessage', ({pad}) => {
-        checkHook('chatNewMessage', ({message}) => {
+            assert(pad != null);
-          message.text = modifiedText;
+            assert(pad instanceof Pad);
-          message.customMetadata = customMetadata;
+            assert.equal(pad.id, padId);
-        }),
+          }),
-        (async () => {
+          sendChat(socket, {text: this.test.title}),
-          const {message} = await listen('CHAT_MESSAGE');
+        ]);
-          assert(message != null);
+      });
-          assert.equal(message.text, modifiedText);
+
-          assert.deepEqual(message.customMetadata, customMetadata);
+      it('padId', async function () {
-        })(),
+        await Promise.all([
-        sendChat(socket, {text: this.test.title}),
+          checkHook('chatNewMessage', (context) => {
-      ]);
+            assert.equal(context.padId, padId);
-      // Simulate fetch of historical chat messages when a pad is first loaded.
+          }),
-      await Promise.all([
+          sendChat(socket, {text: this.test.title}),
-        (async () => {
+        ]);
-          const {messages: [message]} = await listen('CHAT_MESSAGES');
+      });
-          assert(message != null);
+
-          assert.equal(message.text, modifiedText);
+      it('mutations propagate', async function () {
-          assert.deepEqual(message.customMetadata, customMetadata);
+        const listen = async (type) => await new Promise((resolve) => {
-        })(),
+          const handler = (msg) => {
-        sendMessage(socket, {type: 'GET_CHAT_MESSAGES', start: 0, end: 0}),
+            if (msg.type !== 'COLLABROOM') return;
-      ]);
+            if (msg.data == null || msg.data.type !== type) return;
+            resolve(msg.data);
+            socket.off('message', handler);
+          };
+          socket.on('message', handler);
+        });
+
+        const modifiedText = `${this.test.title} <added changes>`;
+        const customMetadata = {foo: this.test.title};
+        await Promise.all([
+          checkHook('chatNewMessage', ({message}) => {
+            message.text = modifiedText;
+            message.customMetadata = customMetadata;
+          }),
+          (async () => {
+            const {message} = await listen('CHAT_MESSAGE');
+            assert(message != null);
+            assert.equal(message.text, modifiedText);
+            assert.deepEqual(message.customMetadata, customMetadata);
+          })(),
+          sendChat(socket, {text: this.test.title}),
+        ]);
+        // Simulate fetch of historical chat messages when a pad is first loaded.
+        await Promise.all([
+          (async () => {
+            const {messages: [message]} = await listen('CHAT_MESSAGES');
+            assert(message != null);
+            assert.equal(message.text, modifiedText);
+            assert.deepEqual(message.customMetadata, customMetadata);
+          })(),
+          sendMessage(socket, {type: 'GET_CHAT_MESSAGES', start: 0, end: 0}),
+        ]);
+      });
+    });
+  });
+
+  describe('settings.integratedChat = false', function () {
+    before(async function () {
+      settings.integratedChat = false;
+      await plugins.update();
+    });
+
+    beforeEach(async function () {
+      await connect();
+    });
+
+    it('clientVars.chatHead is unset', async function () {
+      assert(!('chatHead' in clientVars), `chatHead should be unset, is ${clientVars.chatHead}`);
+    });
+
+    it('rejects CHAT_MESSAGE messages', async function () {
+      await assert.rejects(sendChat(socket, {text: 'this is a test'}), /unknown message type/);
+    });
+
+    it('rejects GET_CHAT_MESSAGES messages', async function () {
+      const msg = {type: 'GET_CHAT_MESSAGES', start: 0, end: 0};
+      await assert.rejects(sendMessage(socket, msg), /unknown message type/);
     });
   });
 });