Merge pull request #21 from ventuno/ftr-support-custom-devtools-cmds-2

Support custom devtools server commands

Author: qiyigg

lib/command_definitions.ts

@@ -146,3 +146,8 @@ export let rotationGesture = new CommandDefinition(
     });
 export let shakeDevice =
     new CommandDefinition<void>('shakeDevice', [], 'POST', 'appium/device/shake');
+export let sendChromiumCommand = new CommandDefinition<void>(
+    'sendChromiumCommand', ['cmd', 'params'], 'POST', '/chromium/send_command');
+export let sendChromiumCommandAndGetResult = new CommandDefinition<Object>(
+    'sendChromiumCommandAndGetResult', ['cmd', 'params'], 'POST',
+    '/chromium/send_command_and_get_result');

lib/index.ts

@@ -141,6 +141,10 @@ export interface ExtendedWebDriver extends WebDriver {
 
   // See https://github.com/webdriverio/webdriverio/blob/v4.6.1/lib/protocol/shake
   shakeDevice: () => wdpromise.Promise<void>;
+
+  sendChromiumCommand: (cmd: string, params: Object) => wdpromise.Promise<void>;
+
+  sendChromiumCommandAndGetResult: (cmd: string, params: Object) => wdpromise.Promise<Object>;
 }
 
 export function extend(baseDriver: WebDriver, fallbackGracefully = false): ExtendedWebDriver {

spec/command_tests/table_spec.ts

@@ -63,7 +63,9 @@ describe('table tests', () => {
     openDeviceNotifications: {},
     rotationGesture: [{params: {x: 0, y: 0, duration: 1, rotation: 180, touchCount: 2}},
         {args: [1,2,3,90,5], params: {x: 1, y: 2, duration: 3, rotation: 90, touchCount: 5}}],
-    shakeDevice: {}
+    shakeDevice: {},
+    sendChromiumCommand: {args: ['DOM.enable', {}]},
+    sendChromiumCommandAndGetResult: {args: ['DOM.enable', {}]}
   }
   function runTestcase(commandName: string) {
     let itName = 'should correctly call "' + commandName + '"';

spec/mock-server/commands/chromium.ts

@@ -0,0 +1,16 @@
+/**
+ * Custom chromium commands
+ *
+ * In this file we define all the custom commands which are part of the chromium API but will probably
+ * never be part of the webdriver spec or JsonWireProtocol.
+ */
+
+import {Command} from 'selenium-mock';
+import {ChromiumCommandList} from '../interfaces';
+import {noopFactory as noop} from './helpers';
+
+export let chromium = {
+  sendChromiumCommand: noop('chromium/send_command'),
+  sendChromiumCommandAndGetResult: noop('chromium/send_command_and_get_result')
+} as ChromiumCommandList;
+

spec/mock-server/commands/index.ts

@@ -6,13 +6,15 @@ import {Command} from 'selenium-mock';
 import {SessionCommandList, ElementCommandList, Session} from '../interfaces';
 import {noopFactory as noop, getterFactory as getter, setterFactory as setter, constFactory} from './helpers';
 import {appium} from './appium';
+import {chromium} from './chromium';
 import {storageFactory} from './storage';
 
 export let session = {
   element: {} as ElementCommandList,
   sessionStorage: storageFactory('session'),
   localStorage: storageFactory('local'),
   appium: appium,
+  chromium: chromium,
 } as SessionCommandList;
 
 session.currentContext = getter('context', 'currentContext');

spec/mock-server/interfaces.ts

@@ -93,6 +93,11 @@ export interface AppiumCommandList extends CommandList {
   device: AppiumDeviceCommandList;
 }
 
+export interface ChromiumCommandList extends CommandList {
+  sendChromiumCommand: Command<Session>;
+  sendChromiumCommandAndGetResult: Command<Session>;
+}
+
 // Commands which run against a particular webdriver session (as opposed to the whole server).
 export interface SessionCommandList extends CommandList {
   currentContext: Command<Session>;
@@ -124,4 +129,5 @@ export interface SessionCommandList extends CommandList {
   sessionStorage: StorageCommandList;
   localStorage: StorageCommandList;
   appium: AppiumCommandList;
+  chromium: ChromiumCommandList;
 }