Issue #3446504 by Utkarsh_33, smustgrave, Tom Konda: Mismatch between...

Issue #3446504 by Utkarsh_33, smustgrave, Tom Konda: Mismatch between implementation and description for Drupal.Message.prototype.remove()

(cherry picked from commit d4e1e52a)

core/misc/message.js

@@ -139,16 +139,16 @@
     }
 
     /**
-     * Removes messages from the message area.
+     * Removes a message element from the message area.
      *
      * @name Drupal.Message~messageDefinition.remove
      *
      * @param {string} id
-     *   Index of the message to remove, as returned by
+     *   The unique identifier of the message to remove, as returned by
      *   {@link Drupal.Message~messageDefinition.add}.
      *
-     * @return {number}
-     *   Number of removed messages.
+     * @return {Element}
+     *   Returns the removed message element.
      */
     remove(id) {
       return this.messageWrapper.removeChild(this.select(id));