zulip/web/tests/notifications.test.js

444 lines
17 KiB
JavaScript

"use strict";
const {strict: assert} = require("assert");
const {mock_esm, zrequire} = require("./lib/namespace");
const {run_test} = require("./lib/test");
const $ = require("./lib/zjquery");
const {page_params, user_settings} = require("./lib/zpage_params");
mock_esm("../src/spoilers", {hide_spoilers_in_notification() {}});
const user_topics = zrequire("user_topics");
const stream_data = zrequire("stream_data");
const desktop_notifications = zrequire("desktop_notifications");
const message_notifications = zrequire("message_notifications");
// Not muted streams
const general = {
subscribed: true,
name: "general",
stream_id: 10,
is_muted: false,
wildcard_mentions_notify: null,
};
// Muted streams
const muted = {
subscribed: true,
name: "muted",
stream_id: 20,
is_muted: true,
wildcard_mentions_notify: null,
};
stream_data.add_sub(general);
stream_data.add_sub(muted);
user_topics.update_user_topics(
general.stream_id,
"muted topic",
user_topics.all_visibility_policies.MUTED,
);
user_topics.update_user_topics(
general.stream_id,
"followed topic",
user_topics.all_visibility_policies.FOLLOWED,
);
function test(label, f) {
run_test(label, (helpers) => {
page_params.is_admin = false;
page_params.realm_users = [];
user_settings.enable_followed_topic_desktop_notifications = true;
user_settings.enable_followed_topic_audible_notifications = true;
user_settings.enable_desktop_notifications = true;
user_settings.enable_sounds = true;
user_settings.enable_followed_topic_wildcard_mentions_notify = true;
user_settings.wildcard_mentions_notify = true;
user_settings.notification_sound = "ding";
f(helpers);
});
}
test("message_is_notifiable", () => {
// A notification is sent if both message_is_notifiable(message)
// and the appropriate should_send_*_notification function return
// true.
// Case 1: If the message was sent by this user,
// DO NOT notify the user
// In this test, all other circumstances should trigger notification
// EXCEPT sent_by_me, which should trump them
let message = {
id: muted.stream_id,
content: "message number 1",
sent_by_me: true,
notification_sent: false,
mentioned: true,
mentioned_me_directly: true,
type: "stream",
stream_id: general.stream_id,
topic: "whatever",
};
assert.equal(message_notifications.should_send_desktop_notification(message), true);
assert.equal(message_notifications.should_send_audible_notification(message), true);
// Not notifiable because it was sent by the current user
assert.equal(message_notifications.message_is_notifiable(message), false);
// Case 2: If the user has already been sent a notification about this message,
// DO NOT notify the user
// In this test, all other circumstances should trigger notification
// EXCEPT notification_sent, which should trump them
// (ie: it mentions user, it's not muted, etc)
message = {
id: general.stream_id,
content: "message number 2",
sent_by_me: false,
notification_sent: true,
mentioned: true,
mentioned_me_directly: true,
type: "stream",
stream_id: general.stream_id,
topic: "whatever",
};
assert.equal(message_notifications.should_send_desktop_notification(message), true);
assert.equal(message_notifications.should_send_audible_notification(message), true);
assert.equal(message_notifications.message_is_notifiable(message), false);
// Case 3: If a message mentions the user directly,
// DO notify the user
// Mentioning trumps muting
message = {
id: 30,
content: "message number 3",
sent_by_me: false,
notification_sent: false,
mentioned: true,
mentioned_me_directly: true,
type: "stream",
stream_id: muted.stream_id,
topic: "topic_three",
};
assert.equal(message_notifications.should_send_desktop_notification(message), true);
assert.equal(message_notifications.should_send_audible_notification(message), true);
assert.equal(message_notifications.message_is_notifiable(message), true);
// Case 4: If the message has been sent to a followed topic,
// DO visually and audibly notify the user if 'enable_followed_topic_desktop_notifications'
// and 'enable_followed_topic_audible_notifications' are enabled, respectively.
// Messages to followed topics trumps muting
message = {
id: 30,
content: "message number 3",
sent_by_me: false,
notification_sent: false,
mentioned: false,
mentioned_me_directly: false,
type: "stream",
stream_id: general.stream_id,
topic: "followed topic",
};
assert.equal(message_notifications.should_send_desktop_notification(message), true);
assert.equal(message_notifications.should_send_audible_notification(message), true);
assert.equal(message_notifications.message_is_notifiable(message), true);
// But not if 'enable_followed_topic_desktop_notifications'
// and 'enable_followed_topic_audible_notifications' are disabled.
user_settings.enable_followed_topic_desktop_notifications = false;
user_settings.enable_followed_topic_audible_notifications = false;
assert.equal(message_notifications.should_send_desktop_notification(message), false);
assert.equal(message_notifications.should_send_audible_notification(message), false);
assert.equal(message_notifications.message_is_notifiable(message), true);
// Reset state
user_settings.enable_followed_topic_desktop_notifications = true;
// Case 5:
// Mentioning should trigger notification in unmuted topic
message = {
id: 40,
content: "message number 4",
sent_by_me: false,
notification_sent: false,
mentioned: true,
mentioned_me_directly: true,
type: "stream",
stream_id: general.stream_id,
topic: "vanilla",
};
assert.equal(message_notifications.should_send_desktop_notification(message), true);
assert.equal(message_notifications.should_send_audible_notification(message), true);
assert.equal(message_notifications.message_is_notifiable(message), true);
// Case 6:
// Wildcard mention should trigger notification in unmuted topic
// if wildcard_mentions_notify
message = {
id: 40,
content: "message number 4",
sent_by_me: false,
notification_sent: false,
mentioned: true,
mentioned_me_directly: false,
type: "stream",
stream_id: general.stream_id,
topic: "vanilla",
};
assert.equal(message_notifications.should_send_desktop_notification(message), true);
assert.equal(message_notifications.should_send_audible_notification(message), true);
assert.equal(message_notifications.message_is_notifiable(message), true);
// But not if it's disabled
user_settings.wildcard_mentions_notify = false;
assert.equal(message_notifications.should_send_desktop_notification(message), false);
assert.equal(message_notifications.should_send_audible_notification(message), false);
assert.equal(message_notifications.message_is_notifiable(message), true);
// And the stream-level setting overrides the global setting
general.wildcard_mentions_notify = true;
assert.equal(message_notifications.should_send_desktop_notification(message), true);
assert.equal(message_notifications.should_send_audible_notification(message), true);
assert.equal(message_notifications.message_is_notifiable(message), true);
// Reset state
user_settings.wildcard_mentions_notify = true;
general.wildcard_mentions_notify = null;
// Case 7: If a message is in a muted stream
// and does not mention the user DIRECTLY (i.e. wildcard mention),
// DO NOT notify the user
message = {
id: 50,
content: "message number 5",
sent_by_me: false,
notification_sent: false,
mentioned: true,
mentioned_me_directly: false,
type: "stream",
stream_id: muted.stream_id,
topic: "whatever",
};
assert.equal(message_notifications.should_send_desktop_notification(message), true);
assert.equal(message_notifications.should_send_audible_notification(message), true);
assert.equal(message_notifications.message_is_notifiable(message), false);
// Case 8: If a message is in a muted stream
// and does mention the user DIRECTLY,
// DO notify the user
message = {
id: 50,
content: "message number 5",
sent_by_me: false,
notification_sent: false,
mentioned: true,
mentioned_me_directly: true,
type: "stream",
stream_id: muted.stream_id,
topic: "whatever",
};
assert.equal(message_notifications.should_send_desktop_notification(message), true);
assert.equal(message_notifications.should_send_audible_notification(message), true);
assert.equal(message_notifications.message_is_notifiable(message), true);
// Case 9: If a message is in a muted topic
// and does not mention the user DIRECTLY (i.e. wildcard mention),
// DO NOT notify the user
message = {
id: 50,
content: "message number 6",
sent_by_me: false,
notification_sent: false,
mentioned: true,
mentioned_me_directly: false,
type: "stream",
stream_id: general.stream_id,
topic: "muted topic",
};
assert.equal(message_notifications.should_send_desktop_notification(message), true);
assert.equal(message_notifications.should_send_audible_notification(message), true);
assert.equal(message_notifications.message_is_notifiable(message), false);
// Case 10:
// Wildcard mentions in a followed topic with 'wildcard_mentions_notify',
// 'enable_followed_topic_desktop_notifications',
// 'enable_followed_topic_audible_notifications' disabled and
// 'enable_followed_topic_wildcard_mentions_notify' enabled;
// DO visually and audibly notify the user
user_settings.wildcard_mentions_notify = false;
user_settings.enable_followed_topic_desktop_notifications = false;
user_settings.enable_followed_topic_audible_notifications = false;
message = {
id: 50,
content: "message number 5",
sent_by_me: false,
notification_sent: false,
mentioned: true,
mentioned_me_directly: false,
type: "stream",
stream_id: general.stream_id,
topic: "followed topic",
};
assert.equal(message_notifications.should_send_desktop_notification(message), true);
assert.equal(message_notifications.should_send_audible_notification(message), true);
assert.equal(message_notifications.message_is_notifiable(message), true);
// But not if 'enable_followed_topic_wildcard_mentions_notify' is disabled
user_settings.enable_followed_topic_wildcard_mentions_notify = false;
assert.equal(message_notifications.should_send_desktop_notification(message), false);
assert.equal(message_notifications.should_send_audible_notification(message), false);
assert.equal(message_notifications.message_is_notifiable(message), true);
// Reset state
user_settings.wildcard_mentions_notify = true;
user_settings.enable_followed_topic_desktop_notifications = true;
user_settings.enable_followed_topic_audible_notifications = true;
user_settings.enable_followed_topic_wildcard_mentions_notify = true;
// Case 11: If `None` is selected as the notification sound, send no
// audible notification, no matter what other user configurations are.
message = {
id: 50,
content: "message number 7",
sent_by_me: false,
notification_sent: false,
mentioned: true,
mentioned_me_directly: true,
type: "stream",
stream_id: general.stream_id,
topic: "whatever",
};
user_settings.notification_sound = "none";
assert.equal(message_notifications.should_send_desktop_notification(message), true);
assert.equal(message_notifications.should_send_audible_notification(message), false);
assert.equal(message_notifications.message_is_notifiable(message), true);
// Reset state
user_settings.notification_sound = "ding";
// If none of the above cases apply
// (ie: topic is not muted, message does not mention user,
// no notification sent before, message not sent by user),
// return true to pass it to notifications settings, which will return false.
message = {
id: 60,
content: "message number 8",
sent_by_me: false,
notification_sent: false,
mentioned: false,
mentioned_me_directly: false,
type: "stream",
stream_id: general.stream_id,
topic: "whatever",
};
assert.equal(message_notifications.should_send_desktop_notification(message), false);
assert.equal(message_notifications.should_send_audible_notification(message), false);
assert.equal(message_notifications.message_is_notifiable(message), true);
});
test("basic_notifications", () => {
$("<div>").set_find_results(".emoji", {replaceWith() {}});
$("<div>").set_find_results("span.katex", {each() {}});
$("<div>").children = () => [];
let n; // Object for storing all notification data for assertions.
let last_closed_message_id = null;
let last_shown_message_id = null;
// Notifications API stub
class StubNotification {
constructor(_title, {icon, body, tag}) {
this.icon = icon;
this.body = body;
this.tag = tag;
// properties for testing.
this.tests = {
shown: false,
};
last_shown_message_id = this.tag;
}
addEventListener() {}
close() {
last_closed_message_id = this.tag;
}
}
desktop_notifications.set_notification_api(StubNotification);
const message_1 = {
id: 1000,
content: "@-mentions the user",
avatar_url: "url",
sent_by_me: false,
sender_full_name: "Jesse Pinkman",
notification_sent: false,
mentioned_me_directly: true,
type: "stream",
stream_id: general.stream_id,
topic: "whatever",
};
const message_2 = {
id: 1500,
avatar_url: "url",
content: "@-mentions the user",
sent_by_me: false,
sender_full_name: "Gus Fring",
notification_sent: false,
mentioned_me_directly: true,
type: "stream",
stream_id: general.stream_id,
topic: "lunch",
};
// Send notification.
message_notifications.process_notification({message: message_1, desktop_notify: true});
n = desktop_notifications.get_notifications();
assert.equal(n.has("Jesse Pinkman to general > whatever"), true);
assert.equal(n.size, 1);
assert.equal(last_shown_message_id, message_1.id);
// Remove notification.
desktop_notifications.close_notification(message_1);
n = desktop_notifications.get_notifications();
assert.equal(n.has("Jesse Pinkman to general > whatever"), false);
assert.equal(n.size, 0);
assert.equal(last_closed_message_id, message_1.id);
// Send notification.
message_1.id = 1001;
message_notifications.process_notification({message: message_1, desktop_notify: true});
n = desktop_notifications.get_notifications();
assert.equal(n.has("Jesse Pinkman to general > whatever"), true);
assert.equal(n.size, 1);
assert.equal(last_shown_message_id, message_1.id);
// Process same message again. Notification count shouldn't increase.
message_1.id = 1002;
message_notifications.process_notification({message: message_1, desktop_notify: true});
n = desktop_notifications.get_notifications();
assert.equal(n.has("Jesse Pinkman to general > whatever"), true);
assert.equal(n.size, 1);
assert.equal(last_shown_message_id, message_1.id);
// Send another message. Notification count should increase.
message_notifications.process_notification({message: message_2, desktop_notify: true});
n = desktop_notifications.get_notifications();
assert.equal(n.has("Gus Fring to general > lunch"), true);
assert.equal(n.has("Jesse Pinkman to general > whatever"), true);
assert.equal(n.size, 2);
assert.equal(last_shown_message_id, message_2.id);
// Remove notifications.
desktop_notifications.close_notification(message_1);
desktop_notifications.close_notification(message_2);
n = desktop_notifications.get_notifications();
assert.equal(n.has("Jesse Pinkman to general > whatever"), false);
assert.equal(n.size, 0);
assert.equal(last_closed_message_id, message_2.id);
});