Support mobile emulate mode (#28)

* Add emulate keywords

* Init emulate mode keyword

* Move emulator to device descriptor file

* Move ref to device descriptors file

* Add emulator keywords

Author: atthaboon

Examples/browser-demo.robot

@@ -39,3 +39,11 @@ Example close puppeteer browser
     Close Puppeteer
     Open browser    http://127.0.0.1:7272   options=${options}    alias=Browser 2
     Click Element    id=get_ajax
+
+Example enable emulator mode
+    [Teardown]    Close All Browser
+    ${HEADLESS}     Get variable value    ${HEADLESS}    ${False}
+    &{options} =    create dictionary   headless=${HEADLESS}
+    Open browser    http://127.0.0.1:7272   options=${options}    alias=Browser 1
+    Enable emulate mode    iPhone SE
+    Capture page screenshot

PuppeteerLibrary/keywords/browsermanagement.py

@@ -198,3 +198,18 @@ def switch_browser(self, alias):
         """Switch browser context based on alias name
         """
         return self.loop.run_until_complete(self.ctx.set_current_context(alias))
+
+    @keyword
+    def enable_emulate_mode(self, emulate_name):
+        """Emulate specific mobile or tablet
+
+        The ``emulate_name`` argument specifies which emulator to use.
+
+        | = Example Options = |
+        | iPhone X            |
+        | Pixel 2             |
+
+        More emulate_name please visit [device_descriptors.py](https://github.com/qahive/robotframework-puppeteer/tree/master/PuppeteerLibrary/utils/device_descriptors.py)
+
+        """
+        return self.loop.run_until_complete(self.async_func.enable_emulate_mode_async(emulate_name))

PuppeteerLibrary/keywords/browsermanagement_async.py

@@ -1,6 +1,7 @@
 import time
 from PuppeteerLibrary.base.robotlibcore import keyword
 from PuppeteerLibrary.base.librarycomponent import LibraryComponent
+from PuppeteerLibrary.utils.device_descriptors import DEVICE_DESCRIPTORS
 
 
 class BrowserManagementKeywordsAsync(LibraryComponent):
@@ -43,3 +44,7 @@ async def close_all_browser_async(self):
     async def close_puppeteer_async(self):
         await self.ctx.browser.close()
         self.ctx.clear_browser()
+
+    @keyword
+    async def enable_emulate_mode_async(self, emulate_name):
+        await self.ctx.get_current_page().emulate(DEVICE_DESCRIPTORS[emulate_name])

PuppeteerLibrary/utils/__init__.py

@@ -0,0 +1 @@
+from .device_descriptors import DEVICE_DESCRIPTORS