added an event as a Casper option

@@ -26,12 +26,15 @@
     /**
     /**
      * Main Casper class. Available options are:
      * Main Casper class. Available options are:
      *
      *
-     *   Type     Name           Default    Description
-     * - Array    clientScripts  ([]):      A collection of script filepaths to include to every page loaded
-     * - String   logLevel       ("error")  Logging level (see logLevels for available values)
-     * - Object   pageSettings   ({}):      PhantomJS's WebPage settings object
-     * - WebPage  page           (null):    An existing WebPage instance
-     * - Boolean  verbose        (false):   Realtime output of log messages
+     * Name              | Type     | Default | Description
+     * ——————————————————+——————————+—————————+————————————————————————————————————————————————————————————————————
+     * clientScripts     | Array    | []      | A collection of script filepaths to include to every page loaded
+     * logLevel          | String   | "error" | Logging level (see logLevels for available values)
+     * onDie             | function | null    | A function to be called when Casper#die() is called
+     * onPageInitialized | function | null    | A function to be called after WebPage instance has been initialized
+     * page              | WebPage  | null    | An existing WebPage instance
+     * pageSettings      | Object   | {}      | PhantomJS's WebPage settings object
+     * verbose           | Boolean  | false   | Realtime output of log messages
      *
      *
      * @param  Object  options  Casper options
      * @param  Object  options  Casper options
      * @return Casper
      * @return Casper
@@ -48,10 +51,9 @@
             clientScripts:     [],
             clientScripts:     [],
             logLevel:          "error",
             logLevel:          "error",
             onDie:             null,
             onDie:             null,
+            onPageInitialized: null,
             page:              null,
             page:              null,
-            pageSettings:   {
-                userAgent: DEFAULT_USER_AGENT,
-            },
+            pageSettings:      { userAgent: DEFAULT_USER_AGENT },
             verbose:           false
             verbose:           false
         };
         };
         // local properties
         // local properties
@@ -398,6 +400,10 @@
             }
             }
             this.page.settings = mergeObjects(this.page.settings, this.options.pageSettings);
             this.page.settings = mergeObjects(this.page.settings, this.options.pageSettings);
             this.started = true;
             this.started = true;
+            if (typeof(this.options.onPageInitialized) === "function") {
+                this.log("Post-configuring WebPage instance", "debug");
+                this.options.onPageInitialized(this.page);
+            }
             if (typeof(location) === "string" && location.length > 0) {
             if (typeof(location) === "string" && location.length > 0) {
                 if (typeof(then) === "function") {
                 if (typeof(then) === "function") {
                     return this.open(location).then(then);
                     return this.open(location).then(then);