provide .clearCache() functionality

README.md

@@ -143,6 +143,7 @@ const chromeless = new Chromeless({
 - [`wait(timeout: number)`](docs/api.md#api-wait-timeout)
 - [`wait(selector: string)`](docs/api.md#api-wait-selector)
 - [`wait(fn: (...args: any[]) => boolean, ...args: any[])`] - Not implemented yet
+- [`clearCache()`](docs/api.md#api-clearcache)
 - [`focus(selector: string)`](docs/api.md#api-focus)
 - [`press(keyCode: number, count?: number, modifiers?: any)`](docs/api.md#api-press)
 - [`type(input: string, selector?: string)`](docs/api.md#api-type)

docs/api.md

@@ -12,6 +12,7 @@ Chromeless provides TypeScript typings.
 - [`wait(timeout: number)`](#api-wait-timeout)
 - [`wait(selector: string)`](#api-wait-selector)
 - [`wait(fn: (...args: any[]) => boolean, ...args: any[])`] - Not implemented yet
+- [`clearCache()`](docs/api.md#api-clearcache)
 - [`focus(selector: string)`](#api-focus)
 - [`press(keyCode: number, count?: number, modifiers?: any)`](#api-press)
 - [`type(input: string, selector?: string)`](#api-type)
@@ -160,6 +161,22 @@ await chromeless.wait(() => { return console.log('@TODO: put a better example he
 
 ---------------------------------------
 
+<a name="api-clearcache" />
+
+### clearCache(): Chromeless<T>
+
+Clears browser cache. 
+
+Service workers and Storage (IndexedDB, WebSQL, etc) needs to be cleared separately. More information at the [Chrome Devtools Protocol website](https://chromedevtools.github.io/devtools-protocol/tot).
+
+__Example__
+
+```js
+await chromeless.clearCache()
+```
+
+---------------------------------------
+
 <a name="api-focus" />
 
 ### focus(selector: string): Chromeless<T>

src/api.ts

@@ -105,6 +105,12 @@ export default class Chromeless<T extends any> implements Promise<T> {
     return this
   }
 
+  clearCache(): Chromeless<T> {
+    this.queue.enqueue({ type: 'clearCache' })
+
+    return this
+  }
+
   focus(selector: string): Chromeless<T> {
     this.queue.enqueue({ type: 'focus', selector })
     return this

src/chrome/local-runtime.ts

@@ -60,6 +60,8 @@ export default class LocalRuntime {
           throw new Error('waitFn not yet implemented')
         }
       }
+      case 'clearCache':
+        return this.clearCache()
       case 'setUserAgent':
         return this.setUserAgent(command.useragent)
       case 'click':
@@ -115,6 +117,17 @@ export default class LocalRuntime {
     this.log(`Navigated to ${url}`)
   }
 
+  private async clearCache(): Promise<void> {
+    const {Network} = this.client
+    const canClearCache = await Network.canClearBrowserCache
+    if (canClearCache) {
+      await Network.clearBrowserCache()
+      this.log(`Cache is cleared`)
+    } else {
+      this.log(`Cache could not be cleared`)
+    }
+  }
+
   private async setUserAgent(useragent: string): Promise<void> {
     this.userAgentValue = useragent
     await this.log(`Set useragent to ${this.userAgentValue}`)

src/types.ts

@@ -61,6 +61,9 @@ export type Command =
       type: 'goto'
       url: string
     }
+  | {
+      type: 'clearCache'
+    }
   | {
       type: 'setViewport'
       options: DeviceMetrics