clearMemoryCache() + clearCache() + Docs

hlr1983 · jefleponot · commit d50b62943d37 · 2017-04-11T09:55:17.000+02:00
diff --git a/docs/modules/casper.rst b/docs/modules/casper.rst
@@ -667,6 +667,54 @@ Think of it as a way to stop javascript execution within the remote DOM environm
 
     casper.run();
 
+.. _casper_clearcache:
+
+.. index:: Memory
+
+``clearCache()``
+-------------------------------------------------------------------------------
+
+**Signature:** ``clearCache()``
+
+.. versionadded:: 1.1.5
+
+Replace current page by a new page object, with newPage() and clear the memory cache, with clearMemoryCache().
+Example::
+
+    casper.start('http://www.google.fr/', function() {
+        this.clearCache(); // cleared the memory cache and replaced page object with newPage().
+    });
+
+    casper.then(function() {
+        // ...
+    });
+
+    casper.run();
+
+.. _casper_clearmemorycache:
+
+.. index:: Memory
+
+``clearMemoryCache()``
+-------------------------------------------------------------------------------
+
+**Signature:** ``clearMemoryCache()``
+
+.. versionadded:: 1.1.5
+
+Use the engine page.clearMemoryCache() to clear the memory cache.
+Example::
+
+    casper.start('http://www.google.fr/', function() {
+        this.clearMemoryCache(); // cleared the memory cache.
+    });
+
+    casper.then(function() {
+        // ...
+    });
+
+    casper.run();
+
 .. index:: Debugging
 
 ``debugHTML()``
diff --git a/modules/casper.js b/modules/casper.js
@@ -464,6 +464,39 @@ Casper.prototype.clear = function clear() {
     return this;
 };
 
+/**
+ * Replace currente page by a new page object, with newPage()
+ * Clears the memory cache, with clearMemoryCache()
+ * 
+ * @return Casper
+ */
+Casper.prototype.clearCache = function clearCache() {
+    "use strict";
+    this.checkStarted();
+    this.page = this.newPage();
+    this.clearMemoryCache();
+    return this;
+};
+
+/**
+ * Clears the memory cache, using engine method
+ * reference: https://github.com/ariya/phantomjs/issues/10357
+ *
+ * @return Casper
+ */
+Casper.prototype.clearMemoryCache = function clearMemoryCache() {
+    "use strict";
+    this.checkStarted();
+    if (typeof this.page.clearMemoryCache === 'function') {
+        this.page.clearMemoryCache();
+    } else if ( phantom.casperEngine === 'slimerjs' || utils.matchEngine({name: 'phantomjs', version: {min: '2.0.0'}}) ) {
+        this.log('clearMemoryCache() did nothing: page.clearMemoryCache is not avliable in this engine', "warning");
+    } else {
+        throw new CasperError("clearMemoryCache(): page.clearMemoryCache should be avaliable in this engine");
+    };
+    return this;
+};
+
 /**
  * Emulates a click on the element from the provided selector using the mouse
  * pointer, if possible.
