chore: mark version v1.4.0

feat: battery percentage changed event (#126 )
New "change_battery" event is triggered when the battery percentage changes. Has current battery percentage and charging state as object param. Co-authored-by: Pedro S. Lopez <pedroslopez@me.com>
2026-04-18 03:29:14 +00:00 · 2020-04-05 23:39:22 -04:00 · 2020-04-05 23:36:03 -04:00 · 2020-04-05 23:04:03 -04:00 · 2020-04-05 22:57:59 -04:00 · 2020-04-05 22:57:36 -04:00
39 changed files with 471 additions and 140 deletions
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-[![npm](https://img.shields.io/npm/v/whatsapp-web.js.svg)](https://www.npmjs.com/package/whatsapp-web.js) [![Depfu](https://badges.depfu.com/badges/4a65a0de96ece65fdf39e294e0c8dcba/overview.svg)](https://depfu.com/github/pedroslopez/whatsapp-web.js?project_id=9765) ![WhatsApp_Web 0.4.1307](https://img.shields.io/badge/WhatsApp_Web-0.4.1307-brightgreen.svg)
+[![npm](https://img.shields.io/npm/v/whatsapp-web.js.svg)](https://www.npmjs.com/package/whatsapp-web.js) [![Depfu](https://badges.depfu.com/badges/4a65a0de96ece65fdf39e294e0c8dcba/overview.svg)](https://depfu.com/github/pedroslopez/whatsapp-web.js?project_id=9765) ![WhatsApp_Web 0.4.2088](https://img.shields.io/badge/WhatsApp_Web-0.4.2088-brightgreen.svg)

 # whatsapp-web.js
 A WhatsApp API client that connects through the WhatsApp Web browser app
@@ -46,7 +46,7 @@ Take a look at [example.js](https://github.com/pedroslopez/whatsapp-web.js/blob/
 | Send messages  | ✅  |
 | Receive messages  | ✅  |
 | Send media (images/audio/documents)  | ✅  |
-| Send media (video)  | ✅ (requires google chrome)  |
+| Send media (video)  | ✅ [(requires google chrome)](https://github.com/pedroslopez/whatsapp-web.js/issues/78#issuecomment-592723583)  |
 | Send stickers | _pending_ |
 | Receive media (images/audio/video/documents)  | ✅  |
 | Send contact cards | _pending_ |
@@ -68,9 +68,34 @@ Something missing? Make an issue and let us know!

 ## Links

-* [Documentation](https://pedroslopez.me/whatsapp-web.js) _(preview)_
+* [Reference](https://pedroslopez.me/whatsapp-web.js)
+* [Guide](https://waguide.pedroslopez.me/) _(work in progress)_
 * [GitHub](https://github.com/pedroslopez/whatsapp-web.js)

 ## Contributing

 Pull requests are welcome! If you see something you'd like to add, please do. For drastic changes, please open an issue first.
+
+## Donating
+
+You can support the maintainer of this project through the link below
+
+[![Support via PayPal](https://cdn.rawgit.com/twolfson/paypal-github-button/1.0.0/dist/button.svg)](https://www.paypal.me/psla/)
+
+## Disclaimer
+
+This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or any of its subsidiaries or its affiliates. The official WhatsApp website can be found at https://whatsapp.com. "WhatsApp" as well as related names, marks, emblems and images are registered trademarks of their respective owners.
+
+## License
+
+Copyright 2019 Pedro S Lopez
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this project except in compliance with the License.
+You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
--- a/docs/Base.html
+++ b/docs/Base.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Class: Base</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Class: Base</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -50,7 +50,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/BusinessContact.html
+++ b/docs/BusinessContact.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Class: BusinessContact</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Class: BusinessContact</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -227,7 +227,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/Chat.html
+++ b/docs/Chat.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Class: Chat</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Class: Chat</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -350,7 +350,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/Client.html
+++ b/docs/Client.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Class: Client</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Class: Client</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -26,7 +26,7 @@
          <header class="page-header">
            <div class="symbol-detail-labels"><span class="label label-kind">class</span></div>
            <h1><small></small><span class="symbol-name">Client</span></h1>
-            <p class="source-link">Source: <a href="Client.js.html#source-line-34">Client.<wbr>js:34</a></p>
+            <p class="source-link">Source: <a href="Client.js.html#source-line-35">Client.<wbr>js:35</a></p>
            <div class="symbol-classdesc">
              <p>Starting point for interacting with the WhatsApp Web API</p>
            </div>
@@ -45,6 +45,9 @@
                    <dt><a href="Client.html#archiveChat">archiveChat()</a></dt>
                    <dd>
                    </dd>
+                    <dt><a href="Client.html#createGroup">createGroup(name, participants)</a></dt>
+                    <dd>
+                    </dd>
                    <dt><a href="Client.html#destroy">destroy()</a></dt>
                    <dd>
                    </dd>
@@ -73,13 +76,13 @@
                    <dt><a href="Client.html#isRegisteredUser">isRegisteredUser()</a></dt>
                    <dd>
                    </dd>
+                    <dt><a href="Client.html#resetState">resetState()</a></dt>
+                    <dd>
+                    </dd>
                  </dl>
                </div>
                <div class="summary-column">
                  <dl class="dl-summary-callout">
-                    <dt><a href="Client.html#resetState">resetState()</a></dt>
-                    <dd>
-                    </dd>
                    <dt><a href="Client.html#sendMessage">sendMessage(chatId, content, options)</a></dt>
                    <dd>
                    </dd>
@@ -107,6 +110,9 @@
                    <dt><a href="Client.html#event:authenticated">authenticated</a></dt>
                    <dd>
                    </dd>
+                    <dt><a href="Client.html#event:change_battery">change_battery</a></dt>
+                    <dd>
+                    </dd>
                    <dt><a href="Client.html#event:change_state">change_state</a></dt>
                    <dd>
                    </dd>
@@ -135,13 +141,13 @@
                    <dt><a href="Client.html#event:message_ack">message_ack</a></dt>
                    <dd>
                    </dd>
+                    <dt><a href="Client.html#event:message_create">message_create</a></dt>
+                    <dd>
+                    </dd>
                  </dl>
                </div>
                <div class="summary-column">
                  <dl class="dl-summary-callout">
-                    <dt><a href="Client.html#event:message_create">message_create</a></dt>
-                    <dd>
-                    </dd>
                    <dt><a href="Client.html#event:message_revoke_everyone">message_revoke_everyone</a></dt>
                    <dd>
                    </dd>
@@ -180,6 +186,7 @@
              <dd><a href="Client.html#event:group_update">Client#event:group_update</a></dd>
              <dd><a href="Client.html#event:disconnected">Client#event:disconnected</a></dd>
              <dd><a href="Client.html#event:change_state">Client#event:change_state</a></dd>
+              <dd><a href="Client.html#event:change_battery">Client#event:change_battery</a></dd>
            </dl>
          </section>
          <section>
@@ -229,6 +236,67 @@
                </dd>
              </dl>
              <div class="symbol-detail-labels"><span class="label label-async">async</span></div>
+              <h3 id="createGroup"><span class="symbol-name">createGroup</span><span class="signature"><span class="signature-params">(name, participants)</span>&nbsp;&rarr; <span class="signature-returns"> (Object, string, or Object with string properties)</span></span></h3>
+              <p>Create a new group</p>
+              <section>
+                <h4>Parameters</h4>
+                <table class="jsdoc-details-table">
+                  <thead>
+                    <tr>
+                      <th>Name</th>
+                      <th>Type</th>
+                      <th>Optional</th>
+                      <th>Description</th>
+                    </tr>
+                  </thead>
+                  <tbody>
+                    <tr>
+                      <td>
+                        <p>name</p>
+                      </td>
+                      <td>
+                        <p>string</p>
+                      </td>
+                      <td>
+                        <p>&nbsp;</p>
+                      </td>
+                      <td>
+                        <p>group title</p>
+                      </td>
+                    </tr>
+                    <tr>
+                      <td>
+                        <p>participants</p>
+                      </td>
+                      <td>
+                        <p>Array of (<a href="Contact.html">Contact</a> or string)</p>
+                      </td>
+                      <td>
+                        <p>&nbsp;</p>
+                      </td>
+                      <td>
+                        <p>an array of Contacts or contact IDs to add to the group</p>
+                      </td>
+                    </tr>
+                  </tbody>
+                </table>
+              </section>
+              <dl class="dl-compact">
+                <dt>Returns</dt>
+                <dd>
+                  <p><code>Object</code> <p>createRes</p>
+                  </p>
+                </dd>
+                <dd>
+                  <p><code>string</code> <p>createRes.gid - ID for the group that was just created</p>
+                  </p>
+                </dd>
+                <dd>
+                  <p><code>Object with string properties</code> <p>createRes.missingParticipants - participants that were not added to the group. Keys represent the ID for participant that was not added and its value is a status code that represents the reason why participant could not be added. This is usually 403 if the user's privacy settings don't allow you to add them to groups.</p>
+                  </p>
+                </dd>
+              </dl>
+              <div class="symbol-detail-labels"><span class="label label-async">async</span></div>
              <h3 id="destroy"><span class="symbol-name">destroy</span><span class="signature"><span class="signature-params">()</span></span></h3>
              <p>Closes the client</p>
              <dl class="dl-compact">
@@ -566,6 +634,79 @@
              </section>
              <dl class="dl-compact">
              </dl>
+              <h3 id="event:change_battery"><span class="symbol-name">change_battery</span></h3>
+              <p>Emitted when the battery percentage for the attached device changes</p>
+              <section>
+                <h4>Parameters</h4>
+                <table class="jsdoc-details-table">
+                  <thead>
+                    <tr>
+                      <th>Name</th>
+                      <th>Type</th>
+                      <th>Optional</th>
+                      <th>Description</th>
+                    </tr>
+                  </thead>
+                  <tbody>
+                    <tr>
+                      <td>
+                        <p>batteryInfo</p>
+                      </td>
+                      <td>
+                        <p>object</p>
+                      </td>
+                      <td>
+                        <p>&nbsp;</p>
+                      </td>
+                      <td>
+                        <p>Values in <code>batteryInfo</code> have the following properties:</p>
+                        <table class="jsdoc-details-table">
+                          <thead>
+                            <tr>
+                              <th>Name</th>
+                              <th>Type</th>
+                              <th>Optional</th>
+                              <th>Description</th>
+                            </tr>
+                          </thead>
+                          <tbody>
+                            <tr>
+                              <td>
+                                <p>battery</p>
+                              </td>
+                              <td>
+                                <p>number</p>
+                              </td>
+                              <td>
+                                <p>&nbsp;</p>
+                              </td>
+                              <td>
+                                <p>The current battery percentage</p>
+                              </td>
+                            </tr>
+                            <tr>
+                              <td>
+                                <p>plugged</p>
+                              </td>
+                              <td>
+                                <p>boolean</p>
+                              </td>
+                              <td>
+                                <p>&nbsp;</p>
+                              </td>
+                              <td>
+                                <p>Indicates if the phone is plugged in (true) or not (false)</p>
+                              </td>
+                            </tr>
+                          </tbody>
+                        </table>
+                      </td>
+                    </tr>
+                  </tbody>
+                </table>
+              </section>
+              <dl class="dl-compact">
+              </dl>
              <h3 id="event:change_state"><span class="symbol-name">change_state</span></h3>
              <p>Emitted when the connection state changes</p>
              <section>
@@ -1006,7 +1147,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/Client.js.html
+++ b/docs/Client.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: Client.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: Client.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -41,7 +41,7 @@ const { WhatsWebURL, UserAgent, DefaultOptions, Events, WAState } &#x3D; require
 const { ExposeStore, LoadUtils } &#x3D; require(&#x27;./util/Injected&#x27;);
 const ChatFactory &#x3D; require(&#x27;./factories/ChatFactory&#x27;);
 const ContactFactory &#x3D; require(&#x27;./factories/ContactFactory&#x27;);
-const { ClientInfo, Message, MessageMedia, Location, GroupNotification } &#x3D; require(&#x27;./structures&#x27;);
+const { ClientInfo, Message, MessageMedia, Contact, Location, GroupNotification } &#x3D; require(&#x27;./structures&#x27;);
 /**
 * Starting point for interacting with the WhatsApp Web API
 * @extends {EventEmitter}
@@ -60,6 +60,7 @@ const { ClientInfo, Message, MessageMedia, Location, GroupNotification } &#x3D;
 * @fires Client#group_update
 * @fires Client#disconnected
 * @fires Client#change_state
+ * @fires Client#change_battery
 */
 class Client extends EventEmitter {
    constructor(options &#x3D; {}) {
@@ -79,6 +80,9 @@ class Client extends EventEmitter {
        const page &#x3D; (await browser.pages())[0];
        page.setUserAgent(UserAgent);

+        this.pupBrowser &#x3D; browser;
+        this.pupPage &#x3D; page;
+        
        if (this.options.session) {
            await page.evaluateOnNewDocument(
                session &#x3D;&gt; {
@@ -97,7 +101,7 @@ class Client extends EventEmitter {
        if (this.options.session) {
            // Check if session restore was successfull 
            try {
-                await page.waitForSelector(KEEP_PHONE_CONNECTED_IMG_SELECTOR, { timeout: 15000 });
+                await page.waitForSelector(KEEP_PHONE_CONNECTED_IMG_SELECTOR, { timeout: this.options.authTimeoutMs });
            } catch (err) {
                if (err.name &#x3D;&#x3D;&#x3D; &#x27;TimeoutError&#x27;) {
                    /**
@@ -130,7 +134,7 @@ class Client extends EventEmitter {
                // Wait for QR Code

                const QR_CANVAS_SELECTOR &#x3D; &#x27;canvas&#x27;;
-                await page.waitForSelector(QR_CANVAS_SELECTOR);
+                await page.waitForSelector(QR_CANVAS_SELECTOR, { timeout: this.options.qrTimeoutMs });
                const qrImgData &#x3D; await page.$eval(QR_CANVAS_SELECTOR, canvas &#x3D;&gt; [].slice.call(canvas.getContext(&#x27;2d&#x27;).getImageData(0, 0, 264, 264).data));
                const qr &#x3D; jsQR(qrImgData, 264, 264).data;
                /**
@@ -141,7 +145,7 @@ class Client extends EventEmitter {
                this.emit(Events.QR_RECEIVED, qr);
            };
            getQrCode();
-            let retryInterval &#x3D; setInterval(getQrCode, 20000); // check for qr code every 20 seconds
+            let retryInterval &#x3D; setInterval(getQrCode, this.options.qrRefreshIntervalMs);

            // Wait for code scan
            await page.waitForSelector(KEEP_PHONE_CONNECTED_IMG_SELECTOR, { timeout: 0 });
@@ -324,6 +328,20 @@ class Client extends EventEmitter {
            }
        });

+        await page.exposeFunction(&#x27;onBatteryStateChangedEvent&#x27;, (state) &#x3D;&gt; {
+
+            const { battery, plugged } &#x3D; state;
+
+            /**
+             * Emitted when the battery percentage for the attached device changes
+             * @event Client#change_battery
+             * @param {object} batteryInfo
+             * @param {number} batteryInfo.battery - The current battery percentage
+             * @param {boolean} batteryInfo.plugged - Indicates if the phone is plugged in (true) or not (false)
+             */
+            this.emit(Events.BATTERY_CHANGED, { battery, plugged });
+        });
+
        await page.evaluate(() &#x3D;&gt; {
            window.Store.Msg.on(&#x27;add&#x27;, (msg) &#x3D;&gt; { if(msg.isNewMsg) window.onAddMessageEvent(msg); });
            window.Store.Msg.on(&#x27;change&#x27;, (msg) &#x3D;&gt; { window.onChangeMessageEvent(msg); });
@@ -332,11 +350,9 @@ class Client extends EventEmitter {
            window.Store.Msg.on(&#x27;change:isUnsentMedia&#x27;, (msg, unsent) &#x3D;&gt; { if(msg.id.fromMe &amp;amp;&amp;amp; !unsent) window.onMessageMediaUploadedEvent(msg); });
            window.Store.Msg.on(&#x27;remove&#x27;, (msg) &#x3D;&gt; { if(msg.isNewMsg) window.onRemoveMessageEvent(msg); });
            window.Store.AppState.on(&#x27;change:state&#x27;, (_AppState, state) &#x3D;&gt; { window.onAppStateChangedEvent(state); });
+            window.Store.Conn.on(&#x27;change:battery&#x27;, (state) &#x3D;&gt; { window.onBatteryStateChangedEvent(state); });
        });

-        this.pupBrowser &#x3D; browser;
-        this.pupPage &#x3D; page;
-
        /**
         * Emitted when the client has initialized and is ready to receive messages.
         * @event Client#ready
@@ -549,6 +565,43 @@ class Client extends EventEmitter {
        }, id);
    }

+    /**
+     * Create a new group
+     * @param {string} name group title
+     * @param {Array&amp;lt;Contact|string&gt;} participants an array of Contacts or contact IDs to add to the group
+     * @returns {Object} createRes
+     * @returns {string} createRes.gid - ID for the group that was just created
+     * @returns {Object.&amp;lt;string,string&gt;} createRes.missingParticipants - participants that were not added to the group. Keys represent the ID for participant that was not added and its value is a status code that represents the reason why participant could not be added. This is usually 403 if the user&#x27;s privacy settings don&#x27;t allow you to add them to groups.
+     */
+    async createGroup(name, participants) {
+        if(!Array.isArray(participants) || participants.length &#x3D;&#x3D; 0) {
+            throw &#x27;You need to add at least one other participant to the group&#x27;;
+        }
+
+        if(participants.every(c &#x3D;&gt; c instanceof Contact)) {
+            participants &#x3D; participants.map(c &#x3D;&gt; c.id._serialized);
+        }
+
+        const createRes &#x3D; await this.pupPage.evaluate(async (name, participantIds) &#x3D;&gt; {
+            const res &#x3D; await window.Store.Wap.createGroup(name, participantIds);
+            console.log(res);
+            if(!res.status &#x3D;&#x3D;&#x3D; 200) {
+                throw &#x27;An error occurred while creating the group!&#x27;;
+            }
+
+            return res;
+        }, name, participants);
+
+        const missingParticipants &#x3D; createRes.participants.reduce(((missing, c) &#x3D;&gt; {
+            const id &#x3D; Object.keys(c)[0];
+            const statusCode &#x3D; c[id].code;
+            if(statusCode !&#x3D; 200) return Object.assign(missing, {[id]: statusCode});
+            return missing;
+        }), {});
+
+        return { gid: createRes.gid, missingParticipants};
+    }
+
 }

 module.exports &#x3D; Client;
@@ -562,7 +615,7 @@ module.exports &#x3D; Client;
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/ClientInfo.html
+++ b/docs/ClientInfo.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Class: ClientInfo</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Class: ClientInfo</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -187,7 +187,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/Contact.html
+++ b/docs/Contact.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Class: Contact</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Class: Contact</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -196,7 +196,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/GroupChat.html
+++ b/docs/GroupChat.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Class: GroupChat</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Class: GroupChat</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -726,7 +726,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/GroupNotification.html
+++ b/docs/GroupNotification.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Class: GroupNotification</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Class: GroupNotification</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -233,7 +233,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/Location.html
+++ b/docs/Location.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Class: Location</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Class: Location</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -149,7 +149,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/Message.html
+++ b/docs/Message.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Class: Message</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Class: Message</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -379,7 +379,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/MessageMedia.html
+++ b/docs/MessageMedia.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Class: MessageMedia</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Class: MessageMedia</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -152,7 +152,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/PrivateChat.html
+++ b/docs/PrivateChat.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Class: PrivateChat</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Class: PrivateChat</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -378,7 +378,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/PrivateContact.html
+++ b/docs/PrivateContact.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Class: PrivateContact</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Class: PrivateContact</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -220,7 +220,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/Util.html
+++ b/docs/Util.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Class: Util</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Class: Util</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -50,7 +50,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/global.html
+++ b/docs/global.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Globals</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Globals</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -338,6 +338,19 @@
                      <td>
                      </td>
                    </tr>
+                    <tr>
+                      <td>
+                        <p>BATTERY_CHANGED</p>
+                      </td>
+                      <td>
+                        <p>&nbsp;</p>
+                      </td>
+                      <td>
+                        <p>&nbsp;</p>
+                      </td>
+                      <td>
+                      </td>
+                    </tr>
                  </tbody>
                </table>
              </section>
@@ -1004,7 +1017,7 @@
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/index.html
+++ b/docs/index.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Home</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Home</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -27,11 +27,11 @@
        <div id="jsdoc-main" role="main">
          <header class="page-header">
            <h1>
-              whatsapp-web.js 1.3.0
+              whatsapp-web.js 1.4.0
            </h1>
          </header>
          <article>
-            <p><a href="https://www.npmjs.com/package/whatsapp-web.js"><img src="https://img.shields.io/npm/v/whatsapp-web.js.svg" alt="npm"></a> <a href="https://depfu.com/github/pedroslopez/whatsapp-web.js?project_id=9765"><img src="https://badges.depfu.com/badges/4a65a0de96ece65fdf39e294e0c8dcba/overview.svg" alt="Depfu"></a> <img src="https://img.shields.io/badge/WhatsApp_Web-0.4.1307-brightgreen.svg" alt="WhatsApp_Web 0.4.1307"></p>
+            <p><a href="https://www.npmjs.com/package/whatsapp-web.js"><img src="https://img.shields.io/npm/v/whatsapp-web.js.svg" alt="npm"></a> <a href="https://depfu.com/github/pedroslopez/whatsapp-web.js?project_id=9765"><img src="https://badges.depfu.com/badges/4a65a0de96ece65fdf39e294e0c8dcba/overview.svg" alt="Depfu"></a> <img src="https://img.shields.io/badge/WhatsApp_Web-0.4.2088-brightgreen.svg" alt="WhatsApp_Web 0.4.2088"></p>
            <h1>whatsapp-web.js</h1>
            <p>A WhatsApp API client that connects through the WhatsApp Web browser app</p>
            <p>It uses Puppeteer to run a real instance of Whatsapp Web to avoid getting blocked.</p>
@@ -84,7 +84,7 @@ client.initialize();
                </tr>
                <tr>
                  <td>Send media (video)</td>
-                  <td>✅ (requires google chrome)</td>
+                  <td>✅ <a href="https://github.com/pedroslopez/whatsapp-web.js/issues/78#issuecomment-592723583">(requires google chrome)</a></td>
                </tr>
                <tr>
                  <td>Send stickers</td>
@@ -155,11 +155,27 @@ client.initialize();
            <p>Something missing? Make an issue and let us know!</p>
            <h2>Links</h2>
            <ul>
-              <li><a href="https://pedroslopez.me/whatsapp-web.js">Documentation</a> <em>(preview)</em></li>
+              <li><a href="https://pedroslopez.me/whatsapp-web.js">Reference</a></li>
+              <li><a href="https://waguide.pedroslopez.me/">Guide</a> <em>(work in progress)</em></li>
              <li><a href="https://github.com/pedroslopez/whatsapp-web.js">GitHub</a></li>
            </ul>
            <h2>Contributing</h2>
            <p>Pull requests are welcome! If you see something you'd like to add, please do. For drastic changes, please open an issue first.</p>
+            <h2>Donating</h2>
+            <p>You can support the maintainer of this project through the link below</p>
+            <p><a href="https://www.paypal.me/psla/"><img src="https://cdn.rawgit.com/twolfson/paypal-github-button/1.0.0/dist/button.svg" alt="Support via PayPal"></a></p>
+            <h2>Disclaimer</h2>
+            <p>This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or any of its subsidiaries or its affiliates. The official WhatsApp website can be found at https://whatsapp.com. &quot;WhatsApp&quot; as well as related names, marks, emblems and images are registered trademarks of their respective owners.</p>
+            <h2>License</h2>
+            <p>Copyright 2019 Pedro S Lopez</p>
+            <p>Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);
+              you may not use this project except in compliance with the License.
+              You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.</p>
+            <p>Unless required by applicable law or agreed to in writing, software
+              distributed under the License is distributed on an &quot;AS IS&quot; BASIS,
+              WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+              See the License for the specific language governing permissions and
+              limitations under the License.</p>
          </article>
          <div class="symbol-index">
            <section>
@@ -444,6 +460,11 @@ client.initialize();
                      </dt>
                      <dd>
                      </dd>
+                      <dt class="symbol-index-name">
+                        <a href="Client.html#createGroup" class="!symbol-index-name">Client#<wbr>createGroup(name, participants)</a>
+                      </dt>
+                      <dd>
+                      </dd>
                      <dt class="symbol-index-name">
                        <a href="Client.html#destroy" class="!symbol-index-name">Client#<wbr>destroy()</a>
                      </dt>
@@ -459,6 +480,11 @@ client.initialize();
                      </dt>
                      <dd>
                      </dd>
+                      <dt class="symbol-index-name">
+                        <a href="Client.html#event:change_battery" class="!symbol-index-name">Client#<wbr>event:change_battery</a>
+                      </dt>
+                      <dd>
+                      </dd>
                      <dt class="symbol-index-name">
                        <a href="Client.html#event:change_state" class="!symbol-index-name">Client#<wbr>event:change_state</a>
                      </dt>
@@ -474,6 +500,10 @@ client.initialize();
                      </dt>
                      <dd>
                      </dd>
+                    </dl>
+                  </div>
+                  <div class="symbol-index-column">
+                    <dl class="symbol-index-list">
                      <dt class="symbol-index-name">
                        <a href="Client.html#event:group_leave" class="!symbol-index-name">Client#<wbr>event:group_leave</a>
                      </dt>
@@ -484,10 +514,6 @@ client.initialize();
                      </dt>
                      <dd>
                      </dd>
-                    </dl>
-                  </div>
-                  <div class="symbol-index-column">
-                    <dl class="symbol-index-list">
                      <dt class="symbol-index-name">
                        <a href="Client.html#event:media_uploaded" class="!symbol-index-name">Client#<wbr>event:media_uploaded</a>
                      </dt>
@@ -533,6 +559,10 @@ client.initialize();
                      </dt>
                      <dd>
                      </dd>
+                    </dl>
+                  </div>
+                  <div class="symbol-index-column">
+                    <dl class="symbol-index-list">
                      <dt class="symbol-index-name">
                        <a href="Client.html#getChats" class="!symbol-index-name">Client#<wbr>getChats()</a>
                      </dt>
@@ -543,10 +573,6 @@ client.initialize();
                      </dt>
                      <dd>
                      </dd>
-                    </dl>
-                  </div>
-                  <div class="symbol-index-column">
-                    <dl class="symbol-index-list">
                      <dt class="symbol-index-name">
                        <a href="Client.html#getContacts" class="!symbol-index-name">Client#<wbr>getContacts()</a>
                      </dt>
@@ -746,6 +772,11 @@ client.initialize();
                      </dt>
                      <dd>
                      </dd>
+                      <dt class="symbol-index-name">
+                        <a href="global.html#Events#.BATTERY_CHANGED" class="!symbol-index-name">Events.<wbr>BATTERY_CHANGED</a>
+                      </dt>
+                      <dd>
+                      </dd>
                      <dt class="symbol-index-name">
                        <a href="global.html#Events#.DISCONNECTED" class="!symbol-index-name">Events.<wbr>DISCONNECTED</a>
                      </dt>
@@ -790,15 +821,15 @@ client.initialize();
                      </dt>
                      <dd>
                      </dd>
-                    </dl>
-                  </div>
-                  <div class="symbol-index-column">
-                    <dl class="symbol-index-list">
                      <dt class="symbol-index-name">
                        <a href="global.html#Events#.MESSAGE_REVOKED_EVERYONE" class="!symbol-index-name">Events.<wbr>MESSAGE_REVOKED_EVERYONE</a>
                      </dt>
                      <dd>
                      </dd>
+                    </dl>
+                  </div>
+                  <div class="symbol-index-column">
+                    <dl class="symbol-index-list">
                      <dt class="symbol-index-name">
                        <a href="global.html#Events#.MESSAGE_REVOKED_ME" class="!symbol-index-name">Events.<wbr>MESSAGE_REVOKED_ME</a>
                      </dt>
@@ -1835,7 +1866,7 @@ client.initialize();
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/structures_Base.js.html
+++ b/docs/structures_Base.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: structures/Base.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: structures/Base.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -60,7 +60,7 @@ module.exports &#x3D; Base;</code></pre>
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/structures_BusinessContact.js.html
+++ b/docs/structures_BusinessContact.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: structures/BusinessContact.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: structures/BusinessContact.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -59,7 +59,7 @@ module.exports &#x3D; BusinessContact;</code></pre>
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/structures_Chat.js.html
+++ b/docs/structures_Chat.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: structures/Chat.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: structures/Chat.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -215,7 +215,7 @@ module.exports &#x3D; Chat;
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/structures_ClientInfo.js.html
+++ b/docs/structures_ClientInfo.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: structures/ClientInfo.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: structures/ClientInfo.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -89,7 +89,7 @@ module.exports &#x3D; ClientInfo;</code></pre>
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/structures_Contact.js.html
+++ b/docs/structures_Contact.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: structures/Contact.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: structures/Contact.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -153,7 +153,7 @@ module.exports &#x3D; Contact;</code></pre>
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/structures_GroupChat.js.html
+++ b/docs/structures_GroupChat.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: structures/GroupChat.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: structures/GroupChat.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -209,7 +209,7 @@ module.exports &#x3D; GroupChat;</code></pre>
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/structures_GroupNotification.js.html
+++ b/docs/structures_GroupNotification.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: structures/GroupNotification.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: structures/GroupNotification.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -74,7 +74,7 @@ class GroupNotification extends Base {
         * 
         * @type {string}
         */
-        this.chatId &#x3D; typeof (data.to) &#x3D;&#x3D;&#x3D; &#x27;object&#x27; ? data.to._serialized : data.to;
+        this.chatId &#x3D; typeof (data.from) &#x3D;&#x3D;&#x3D; &#x27;object&#x27; ? data.from._serialized : data.from;

        /**
         * ContactId for the user that produced the GroupNotification.
@@ -143,7 +143,7 @@ module.exports &#x3D; GroupNotification;
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/structures_Location.js.html
+++ b/docs/structures_Location.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: structures/Location.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: structures/Location.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -71,7 +71,7 @@ module.exports &#x3D; Location;</code></pre>
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/structures_Message.js.html
+++ b/docs/structures_Message.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: structures/Message.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: structures/Message.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -231,7 +231,7 @@ class Message extends Base {
                await msg.downloadMedia(true, 1);
            }
            
-            if(msg.mediaData.mediaStage !&#x3D; &#x27;RESOLVED&#x27;) {
+            if(msg.mediaData.mediaStage.includes(&#x27;ERROR&#x27;)) {
                // media could not be downloaded
                return undefined;
            }
@@ -280,7 +280,7 @@ module.exports &#x3D; Message;
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/structures_MessageMedia.js.html
+++ b/docs/structures_MessageMedia.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: structures/MessageMedia.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: structures/MessageMedia.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -69,7 +69,7 @@ module.exports &#x3D; MessageMedia;</code></pre>
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/structures_PrivateChat.js.html
+++ b/docs/structures_PrivateChat.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: structures/PrivateChat.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: structures/PrivateChat.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -51,7 +51,7 @@ module.exports &#x3D; PrivateChat;</code></pre>
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/structures_PrivateContact.js.html
+++ b/docs/structures_PrivateContact.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: structures/PrivateContact.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: structures/PrivateContact.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -51,7 +51,7 @@ module.exports &#x3D; PrivateContact;</code></pre>
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/util_Constants.js.html
+++ b/docs/util_Constants.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: util/Constants.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: util/Constants.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -39,7 +39,10 @@ exports.DefaultOptions &#x3D; {
    puppeteer: {
        headless: true
    },
-    session: false
+    session: false,
+    qrTimeoutMs: 45000,
+    qrRefreshIntervalMs: 20000,
+    authTimeoutMs: 45000,
 };

 /**
@@ -74,6 +77,7 @@ exports.Events &#x3D; {
    QR_RECEIVED: &#x27;qr&#x27;,
    DISCONNECTED: &#x27;disconnected&#x27;,
    STATE_CHANGED: &#x27;change_state&#x27;,
+    BATTERY_CHANGED: &#x27;change_battery&#x27;
 };

 /**
@@ -167,7 +171,7 @@ exports.MessageAck &#x3D; {
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/docs/util_Util.js.html
+++ b/docs/util_Util.js.html
@@ -4,7 +4,7 @@
 <head>
  <meta name="generator" content="JSDoc 3.6.3">
  <meta charset="utf-8">
-  <title>whatsapp-web.js 1.3.0 &raquo; Source: util/Util.js</title>
+  <title>whatsapp-web.js 1.4.0 &raquo; Source: util/Util.js</title>
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Karla:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Noto+Serif:400,400i,700,700i" type="text/css">
  <link rel="stylesheet" href="https://brick.a.ssl.fastly.net/Inconsolata:500" type="text/css">
@@ -15,7 +15,7 @@
  <nav id="jsdoc-navbar" role="navigation" class="jsdoc-navbar">
    <div id="jsdoc-navbar-container">
      <div id="jsdoc-navbar-content">
-        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>3.<wbr>0</a>
+        <a href="index.html" class="jsdoc-navbar-package-name">whatsapp-web.<wbr>js 1.<wbr>4.<wbr>0</a>
      </div>
    </div>
  </nav>
@@ -73,7 +73,7 @@ module.exports &#x3D; Util;</code></pre>
  <footer id="jsdoc-footer" class="jsdoc-footer">
    <div id="jsdoc-footer-container">
      <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on March 29, 2020.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.3 on April 5, 2020.
      </p>
    </div>
  </footer>
--- a/example.js
+++ b/example.js
@@ -237,6 +237,12 @@ client.on('group_update', (notification) => {
    console.log('update', notification);
 });

+client.on('change_battery', (batteryInfo) => {
+    // Battery percentage for attached device has changed
+    const { battery, plugged } = batteryInfo;
+    console.log(`Battery: ${battery}% - Charging? ${plugged}`);
+});
+
 client.on('disconnected', (reason) => {
    console.log('Client was logged out', reason);
 });
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "whatsapp-web.js",
-  "version": "1.3.0",
+  "version": "1.4.0",
  "description": "Library for interacting with the WhatsApp Web API ",
  "main": "./index.js",
  "scripts": {
--- a/src/Client.js
+++ b/src/Client.js
@@ -10,7 +10,7 @@ const { WhatsWebURL, UserAgent, DefaultOptions, Events, WAState } = require('./u
 const { ExposeStore, LoadUtils } = require('./util/Injected');
 const ChatFactory = require('./factories/ChatFactory');
 const ContactFactory = require('./factories/ContactFactory');
-const { ClientInfo, Message, MessageMedia, Location, GroupNotification } = require('./structures');
+const { ClientInfo, Message, MessageMedia, Contact, Location, GroupNotification } = require('./structures');
 /**
 * Starting point for interacting with the WhatsApp Web API
 * @extends {EventEmitter}
@@ -29,6 +29,7 @@ const { ClientInfo, Message, MessageMedia, Location, GroupNotification } = requi
 * @fires Client#group_update
 * @fires Client#disconnected
 * @fires Client#change_state
+ * @fires Client#change_battery
 */
 class Client extends EventEmitter {
    constructor(options = {}) {
@@ -48,6 +49,9 @@ class Client extends EventEmitter {
        const page = (await browser.pages())[0];
        page.setUserAgent(UserAgent);

+        this.pupBrowser = browser;
+        this.pupPage = page;
+        
        if (this.options.session) {
            await page.evaluateOnNewDocument(
                session => {
@@ -66,7 +70,7 @@ class Client extends EventEmitter {
        if (this.options.session) {
            // Check if session restore was successfull 
            try {
-                await page.waitForSelector(KEEP_PHONE_CONNECTED_IMG_SELECTOR, { timeout: 15000 });
+                await page.waitForSelector(KEEP_PHONE_CONNECTED_IMG_SELECTOR, { timeout: this.options.authTimeoutMs });
            } catch (err) {
                if (err.name === 'TimeoutError') {
                    /**
@@ -99,7 +103,7 @@ class Client extends EventEmitter {
                // Wait for QR Code

                const QR_CANVAS_SELECTOR = 'canvas';
-                await page.waitForSelector(QR_CANVAS_SELECTOR);
+                await page.waitForSelector(QR_CANVAS_SELECTOR, { timeout: this.options.qrTimeoutMs });
                const qrImgData = await page.$eval(QR_CANVAS_SELECTOR, canvas => [].slice.call(canvas.getContext('2d').getImageData(0, 0, 264, 264).data));
                const qr = jsQR(qrImgData, 264, 264).data;
                /**
@@ -110,7 +114,7 @@ class Client extends EventEmitter {
                this.emit(Events.QR_RECEIVED, qr);
            };
            getQrCode();
-            let retryInterval = setInterval(getQrCode, 20000); // check for qr code every 20 seconds
+            let retryInterval = setInterval(getQrCode, this.options.qrRefreshIntervalMs);

            // Wait for code scan
            await page.waitForSelector(KEEP_PHONE_CONNECTED_IMG_SELECTOR, { timeout: 0 });
@@ -293,6 +297,20 @@ class Client extends EventEmitter {
            }
        });

+        await page.exposeFunction('onBatteryStateChangedEvent', (state) => {
+
+            const { battery, plugged } = state;
+
+            /**
+             * Emitted when the battery percentage for the attached device changes
+             * @event Client#change_battery
+             * @param {object} batteryInfo
+             * @param {number} batteryInfo.battery - The current battery percentage
+             * @param {boolean} batteryInfo.plugged - Indicates if the phone is plugged in (true) or not (false)
+             */
+            this.emit(Events.BATTERY_CHANGED, { battery, plugged });
+        });
+
        await page.evaluate(() => {
            window.Store.Msg.on('add', (msg) => { if(msg.isNewMsg) window.onAddMessageEvent(msg); });
            window.Store.Msg.on('change', (msg) => { window.onChangeMessageEvent(msg); });
@@ -301,11 +319,9 @@ class Client extends EventEmitter {
            window.Store.Msg.on('change:isUnsentMedia', (msg, unsent) => { if(msg.id.fromMe && !unsent) window.onMessageMediaUploadedEvent(msg); });
            window.Store.Msg.on('remove', (msg) => { if(msg.isNewMsg) window.onRemoveMessageEvent(msg); });
            window.Store.AppState.on('change:state', (_AppState, state) => { window.onAppStateChangedEvent(state); });
+            window.Store.Conn.on('change:battery', (state) => { window.onBatteryStateChangedEvent(state); });
        });

-        this.pupBrowser = browser;
-        this.pupPage = page;
-
        /**
         * Emitted when the client has initialized and is ready to receive messages.
         * @event Client#ready
@@ -518,6 +534,43 @@ class Client extends EventEmitter {
        }, id);
    }

+    /**
+     * Create a new group
+     * @param {string} name group title
+     * @param {Array<Contact|string>} participants an array of Contacts or contact IDs to add to the group
+     * @returns {Object} createRes
+     * @returns {string} createRes.gid - ID for the group that was just created
+     * @returns {Object.<string,string>} createRes.missingParticipants - participants that were not added to the group. Keys represent the ID for participant that was not added and its value is a status code that represents the reason why participant could not be added. This is usually 403 if the user's privacy settings don't allow you to add them to groups.
+     */
+    async createGroup(name, participants) {
+        if(!Array.isArray(participants) || participants.length == 0) {
+            throw 'You need to add at least one other participant to the group';
+        }
+
+        if(participants.every(c => c instanceof Contact)) {
+            participants = participants.map(c => c.id._serialized);
+        }
+
+        const createRes = await this.pupPage.evaluate(async (name, participantIds) => {
+            const res = await window.Store.Wap.createGroup(name, participantIds);
+            console.log(res);
+            if(!res.status === 200) {
+                throw 'An error occurred while creating the group!';
+            }
+
+            return res;
+        }, name, participants);
+
+        const missingParticipants = createRes.participants.reduce(((missing, c) => {
+            const id = Object.keys(c)[0];
+            const statusCode = c[id].code;
+            if(statusCode != 200) return Object.assign(missing, {[id]: statusCode});
+            return missing;
+        }), {});
+
+        return { gid: createRes.gid, missingParticipants};
+    }
+
 }

 module.exports = Client;
--- a/src/structures/GroupNotification.js
+++ b/src/structures/GroupNotification.js
@@ -43,7 +43,7 @@ class GroupNotification extends Base {
         * 
         * @type {string}
         */
-        this.chatId = typeof (data.to) === 'object' ? data.to._serialized : data.to;
+        this.chatId = typeof (data.from) === 'object' ? data.from._serialized : data.from;

        /**
         * ContactId for the user that produced the GroupNotification.
--- a/src/structures/Message.js
+++ b/src/structures/Message.js
@@ -200,7 +200,7 @@ class Message extends Base {
                await msg.downloadMedia(true, 1);
            }
            
-            if(msg.mediaData.mediaStage != 'RESOLVED') {
+            if(msg.mediaData.mediaStage.includes('ERROR')) {
                // media could not be downloaded
                return undefined;
            }
--- a/src/structures/index.js
+++ b/src/structures/index.js
@@ -10,4 +10,5 @@ module.exports = {
    MessageMedia: require('./MessageMedia'),
    PrivateChat: require('./PrivateChat'),
    PrivateContact: require('./PrivateContact'),
+    GroupNotification: require('./GroupNotification')
 };
--- a/src/util/Constants.js
+++ b/src/util/Constants.js
@@ -8,7 +8,10 @@ exports.DefaultOptions = {
    puppeteer: {
        headless: true
    },
-    session: false
+    session: false,
+    qrTimeoutMs: 45000,
+    qrRefreshIntervalMs: 20000,
+    authTimeoutMs: 45000,
 };

 /**
@@ -43,6 +46,7 @@ exports.Events = {
    QR_RECEIVED: 'qr',
    DISCONNECTED: 'disconnected',
    STATE_CHANGED: 'change_state',
+    BATTERY_CHANGED: 'change_battery'
 };

 /**
Author	SHA1	Message	Date
Pedro Lopez	3cbf1e9c2f	chore: mark version v1.4.0	2020-04-05 23:39:22 -04:00
Aliyss Snow	93a617336a	feat: battery percentage changed event (#126 ) New "change_battery" event is triggered when the battery percentage changes. Has current battery percentage and charging state as object param. Co-authored-by: Pedro S. Lopez <pedroslopez@me.com>	2020-04-05 23:36:03 -04:00
kurob1993	1780436b93	fix: make pupBrowser and pupPage available sooner (#137 ) * move this.pupBrowser variable to line 51 to resolve not being able to close the browser when it is not connected to the internet * move pupPage along with pupBrowser Co-authored-by: Pedro S. Lopez <pedroslopez@me.com>	2020-04-05 23:04:03 -04:00
Pedro Lopez	7acbd3d800	fix: properly set chatId This was causing errors when using the .reply() function	2020-04-05 22:57:59 -04:00
Pedro Lopez	67435b2244	fix: group events were not being triggered	2020-04-05 22:57:36 -04:00
Pedro Lopez	743ac93f6e	feat: allow setting timeouts via options	2020-04-03 01:49:16 -04:00
Pedro Lopez	0a7412cf17	feat: create groups close #131	2020-04-03 01:45:06 -04:00
Pedro Lopez	d1e357d23b	chore: bump version v1.3.1-post	2020-04-02 02:35:36 -04:00
Pedro Lopez	3610cef926	chore(docs): mark v1.3.1	2020-04-02 02:33:44 -04:00
Pedro Lopez	4e5eeace2f	chore: mark v1.3.1	2020-04-02 02:33:17 -04:00
Pedro Lopez	6c43a2d2ed	fix: increase timeouts close #130	2020-04-02 02:30:50 -04:00
Pedro Lopez	001c045c08	fix: only return undefined for ERROR_* media states This was causing a regression as of 1.2.5 that caused media files sent by the client to not be properly downloaded cc #111 @stevefold	2020-04-02 02:24:12 -04:00
Pedro S. Lopez	c3ba79464b	Update README.md	2020-03-31 12:43:03 -04:00
Pedro Lopez	237331b656	chore: bump version to v1.3.0-post	2020-03-29 23:59:05 -04:00