mirror of
https://github.com/zulip/zulip.git
synced 2025-11-06 06:53:25 +00:00
e96ede0ef6
For spectators, the chunk of page_params that originates from do_events_register isn’t assigned until ui_init.js. That means the TypeScript type of page_params is mostly a lie during module load time: reading a parameter too early silently results in undefined rather than the declared type, with unpredictable results later on. We want to make such an early read into an immediate runtime error, for both users and spectators consistently, and pave the way for runtime validation of the page_params type. As a first step, split out the subset of fields that pertain to the current user. Signed-off-by: Anders Kaseorg <anders@zulip.com>
444 lines
17 KiB
JavaScript
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 {current_user, 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) => {
|
|
current_user.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);
|
|
});
|