1 files changed, 60 insertions, 0 deletions
diff --git a/devtools/client/responsive/utils/notification.js b/devtools/client/responsive/utils/notification.js
new file mode 100644
index 0000000000..a261fe4252
--- /dev/null
+++ b/devtools/client/responsive/utils/notification.js
@@ -0,0 +1,60 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+"use strict";
+
+loader.lazyRequireGetter(
+  this,
+  "gDevTools",
+  "resource://devtools/client/framework/devtools.js",
+  true
+);
+
+/**
+ * Displays a notification either at the browser or toolbox level, depending on whether
+ * a toolbox is currently open for this tab.
+ *
+ * @param window
+ *        The main browser chrome window.
+ * @param tab
+ *        The browser tab.
+ * @param options
+ *        Other options associated with opening.  Currently includes:
+ *        - `toolbox`: Whether initiated via toolbox button
+ *        - `msg`: String to show in the notification
+ *        - `priority`: Priority level for the notification, which affects the icon and
+ *                      overall appearance.
+ */
+async function showNotification(
+  window,
+  tab,
+  { toolboxButton, msg, priority } = {}
+) {
+  // Default to using the browser's per-tab notification box
+  let nbox = window.gBrowser.getNotificationBox(tab.linkedBrowser);
+
+  // If opening was initiated by a toolbox button, check for an open
+  // toolbox for the tab.  If one exists, use the toolbox's notification box so that the
+  // message is placed closer to the action taken by the user.
+  if (toolboxButton) {
+    const toolbox = gDevTools.getToolboxForTab(tab);
+    if (toolbox) {
+      nbox = toolbox.notificationBox;
+    }
+  }
+
+  const value = "devtools-responsive";
+  if (nbox.getNotificationWithValue(value)) {
+    // Notification already displayed
+    return;
+  }
+
+  if (!priority) {
+    priority = nbox.PRIORITY_INFO_MEDIUM;
+  }
+
+  nbox.appendNotification(value, { label: msg, priority });
+}
+
+exports.showNotification = showNotification;