casperjs 1.0.0.RC1 → 1.0.0

data/samples/cliplay.js

@@ -1,3 +1,6 @@
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
 var casper = require("casper").create();
 var dump = require("utils").dump;
 

data/samples/customevents.js

@@ -1,3 +1,6 @@
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
 var casper = require("casper").create();
 
 // listening to a custom event

data/samples/customlogging.coffee

@@ -2,29 +2,27 @@
 A basic custom logging implementation. The idea is to (extremely) verbosely
 log every received resource.
 ###
-
 casper = require("casper").create
-    ###
-    Every time a resource is received, a new log entry is added to the stack
-    at the 'verbose' level.
-
-    @param  Object  resource  A phantomjs resource object
-    ###
-    onResourceReceived: (self, resource) ->
-        infos = []
-        props = [
-            "url"
-            "status"
-            "statusText"
-            "redirectURL"
-            "bodySize"
-        ]
-        infos.push resource[prop] for prop in props
-        infos.push "[#{header.name}: #{header.value}]" for header in resource.headers
-        @log infos.join(", "), "verbose"
     verbose: true       # we want to see the log printed out to the console
     logLevel: "verbose" # of course we want to see logs to our new level :)
 
+###
+Every time a resource is received, a new log entry is added to the stack
+at the 'verbose' level.
+###
+casper.on 'resource.received', (resource) ->
+    infos = []
+    props = [
+        "url"
+        "status"
+        "statusText"
+        "redirectURL"
+        "bodySize"
+    ]
+    infos.push resource[prop] for prop in props
+    infos.push "[#{header.name}: #{header.value}]" for header in resource.headers
+    @log infos.join(", "), "verbose"
+
 # add a new 'verbose' logging level at the lowest priority
 casper.logLevels = ["verbose"].concat casper.logLevels
 

data/samples/customlogging.js

@@ -1,38 +1,37 @@
-/*
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
+/**
  * A basic custom logging implementation. The idea is to (extremely) verbosely
  * log every received resource.
  */
-
 var casper = require("casper").create({
-    /*
-    Every time a resource is received, a new log entry is added to the stack at
-    the 'verbose' level.
-    */
-    onResourceReceived: function(self, resource) {
-        var header, infos, prop, props, _i, _j, _len, _len1, _ref;
-        infos = [];
-        props = [
-            "url",
-            "status",
-            "statusText",
-            "redirectURL",
-            "bodySize"
-        ];
-        for (_i = 0, _len = props.length; _i < _len; _i++) {
-            prop = props[_i];
-            infos.push(resource[prop]);
-        }
-        _ref = resource.headers;
-        for (_j = 0, _len1 = _ref.length; _j < _len1; _j++) {
-            header = _ref[_j];
-            infos.push("[" + header.name + ": " + header.value + "]");
-        }
-        this.log(infos.join(", "), "verbose");
-    },
     verbose: true,
     logLevel: "verbose"
 });
 
+/**
+ * Every time a resource is received, a new log entry is added to the stack at
+ * the 'verbose' level.
+ */
+casper.on('resource.received', function(resource) {
+    var infos = [];
+    var props = [
+        "url",
+        "status",
+        "statusText",
+        "redirectURL",
+        "bodySize"
+    ];
+    props.forEach(function(prop) {
+        infos.push(resource[prop]);
+    });
+    resource.headers.forEach(function(header) {
+        infos.push("[" + header.name + ": " + header.value + "]");
+    });
+    this.log(infos.join(", "), "verbose");
+});
+
 // add a new 'verbose' logging level at the lowest priority
 casper.logLevels = ["verbose"].concat(casper.logLevels);
 

data/samples/download.js

@@ -1,4 +1,7 @@
-/*
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
+/**
  * download the google logo image onto the local filesystem
  */
 

data/samples/dynamic.js

@@ -1,3 +1,6 @@
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
 var casper = require("casper").create({
     verbose: true
 });

data/samples/each.js

@@ -1,3 +1,6 @@
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
 var casper = require("casper").create();
 
 var links = [

data/samples/events.js

@@ -1,7 +1,9 @@
-/*
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
+/**
  * This script will add a custom HTTP status code handler, here for 404 pages.
  */
-
 var casper = require("casper").create();
 
 casper.on("http.status.200", function(resource) {

data/samples/extends.js

@@ -1,3 +1,6 @@
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
 var casper = require("casper").create({
     loadImages: false,
     logLevel:   "debug",
@@ -34,4 +37,4 @@ Object.keys(links).forEach(function(url) {
 fantomas.run(function() {
     this.renderJSON(links);
     this.exit();
-});
+});

data/samples/googlelinks.coffee

@@ -4,7 +4,10 @@ casper = require("casper").create()
 getLinks = ->
     links = document.querySelectorAll("h3.r a")
     Array::map.call links, (e) ->
-        e.getAttribute "href"
+        try
+            (/url\?q=(.*)&sa=U/).exec(e.getAttribute("href"))[1]
+        catch e
+            e.getAttribute "href"
 
 casper.start "http://google.fr/", ->
     # search for 'casperjs' from google form

data/samples/googlelinks.js

@@ -1,12 +1,19 @@
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
 var links = [];
 var casper = require("casper").create();
 
 function getLinks() {
     var links = document.querySelectorAll("h3.r a");
     return Array.prototype.map.call(links, function(e) {
-        return e.getAttribute("href");
+        try {
+            // google handles redirects hrefs to some script of theirs
+            return (/url\?q=(.*)&sa=U/).exec(e.getAttribute("href"))[1];
+        } catch (err) {
+            return e.getAttribute("href");
+        }
     });
-};
+}
 
 casper.start("http://google.fr/", function() {
     // search for 'casperjs' from google form
@@ -28,6 +35,6 @@ casper.then(function() {
 casper.run(function() {
     // echo results in some pretty fashion
     this.echo(links.length + " links found:");
-    this.echo(" - " + links.join("\n - "))
+    this.echo(" - " + links.join("\n - "));
     this.exit();
 });

data/samples/googlematch.coffee

@@ -14,7 +14,7 @@ casper = require("casper").create verbose: true
 
 casper.fetchScore = ->
     @evaluate ->
-        result = document.querySelector('#resultStats').innerText
+        result = __utils__.findOne('#resultStats').innerText
         parseInt /Environ ([0-9\s]{1,}).*/.exec(result)[1].replace(/\s/g, '')
 
 terms = casper.cli.args # terms are passed through command-line arguments

data/samples/googlematch.js

@@ -1,4 +1,7 @@
-/*
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
+/**
  * Takes provided terms passed as arguments and query google for the number of
  * estimated results each have.
  *
@@ -16,7 +19,7 @@ var casper = require("casper").create({
 
 casper.fetchScore = function() {
     return this.evaluate(function() {
-        var result = document.querySelector('#resultStats').innerText;
+        var result = __utils__.findOne('#resultStats').innerText;
         return parseInt(/Environ ([0-9\s]{1,}).*/.exec(result)[1].replace(/\s/g, ''), 10);
     });
 };

data/samples/googlepagination.js

@@ -1,4 +1,7 @@
-/*
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
+/**
  * Capture multiple pages of google search results
  *
  * Usage: $ casperjs googlepagination.coffee my search terms

data/samples/googletesting.js

@@ -1,3 +1,6 @@
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
 var casper = require("casper").create({
     logLevel: "debug"
 });

data/samples/logcolor.js

@@ -1,3 +1,6 @@
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
 var casper = require("casper").create({
     verbose: true,
     logLevel: "debug"

data/samples/metaextract.js

@@ -1,3 +1,6 @@
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
 var casper = require("casper").create();
 var url = casper.cli.get(0);
 var metas = [];

data/samples/multirun.js

@@ -1,3 +1,6 @@
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
 var casper = require("casper").create({
     verbose: true
 });

data/samples/screenshot.js

@@ -1,4 +1,7 @@
-/*
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
+/**
  * This script will capture a screenshot of a twitter account page
  * Usage: $ casperjs screenshot.coffee <twitter-account> <filename.[jpg|png|pdf]>
  */

data/samples/statushandlers.js

@@ -1,4 +1,7 @@
-/*
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
+/**
  * This script will add a custom HTTP status code handler, here for 404 pages.
  */
 

data/samples/steptimeout.js

@@ -1,3 +1,6 @@
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
 var failed = [];
 var start = null;
 var links = [

data/samples/timeout.js

@@ -1,4 +1,7 @@
-/*
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
+/**
  * Just a silly game.
  *
  * $ casperjs samples/timeout.js 500

data/samples/translate.coffee

@@ -0,0 +1,23 @@
+###
+Translation using the Google Translate Service.
+
+Usage:
+
+$ casperjs translate.coffee --target=fr "hello world"
+bonjour tout le monde
+###
+system = require("system")
+casper = require("casper").create()
+format = require("utils").format
+source = casper.cli.get("source") or "auto"
+target = casper.cli.get("target")
+text = casper.cli.get(0)
+result = undefined
+
+casper.warn("The --target option is mandatory.").exit 1  unless target
+
+casper.start(format("http://translate.google.com/#%s/%s/%s", source, target, text), ->
+  @fill "form#gt-form", text: text
+).waitForSelector "span.hps", -> @echo @fetchText("#result_box")
+
+casper.run()

data/samples/translate.js

@@ -0,0 +1,30 @@
+/*jshint strict:false*/
+/*global CasperError console phantom require*/
+
+/**
+ * Translation using the Google Translate Service.
+ *
+ * Usage:
+ *
+ *     $ casperjs translate.js --target=fr "hello world"
+ *     bonjour tout le monde
+ */
+var system = require('system'),
+    casper = require('casper').create(),
+    format = require('utils').format,
+    source = casper.cli.get('source') || 'auto',
+    target = casper.cli.get('target'),
+    text   = casper.cli.get(0),
+    result;
+
+if (!target) {
+    casper.warn('The --target option is mandatory.').exit(1);
+}
+
+casper.start(format('http://translate.google.com/#%s/%s/%s', source, target, text), function() {
+    this.fill('form#gt-form', {text: text});
+}).waitForSelector('span.hps', function() {
+    this.echo(this.fetchText("#result_box"));
+});
+
+casper.run();

data/tests/commands/mytest.js

@@ -0,0 +1,14 @@
+/*jshint strict:false*/
+/*global CasperError casper console phantom require*/
+casper.start('about:blank', function() {
+    this.test.pass('ok1');
+});
+
+casper.then(function() {
+    this.test.pass('ok2');
+});
+
+casper.run(function() {
+    this.test.pass('ok3');
+    this.test.done();
+});

data/tests/commands/script.js

@@ -0,0 +1,3 @@
+var casper = require('casper').create();
+casper.echo('it works');
+casper.exit();

data/tests/run.js

@@ -1,19 +1,35 @@
+/*global phantom CasperError*/
+
 if (!phantom.casperLoaded) {
     console.log('This script must be invoked using the casperjs executable');
     phantom.exit(1);
 }
 
-var fs = require('fs');
-var utils = require('utils');
-var f = utils.format;
-var includes = [];
-var tests = [];
-var casper = require('casper').create({
+var fs           = require('fs');
+var colorizer    = require('colorizer');
+var utils        = require('utils');
+var f            = utils.format;
+var loadIncludes = ['includes', 'pre', 'post'];
+var tests        = [];
+var casper       = require('casper').create({
     exitOnError: false
 });
 
 // local utils
+function checkSelfTest(tests) {
+    "use strict";
+    var isCasperTest = false;
+    tests.forEach(function(test) {
+        var testDir = fs.absolute(fs.dirname(test));
+        if (fs.isDirectory(testDir) && fs.exists(fs.pathJoin(testDir, '.casper'))) {
+            isCasperTest = true;
+        }
+    });
+    return isCasperTest;
+}
+
 function checkIncludeFile(include) {
+    "use strict";
     var absInclude = fs.absolute(include.trim());
     if (!fs.exists(absInclude)) {
         casper.warn("%s file not found, can't be included", absInclude);
@@ -34,43 +50,72 @@ function checkIncludeFile(include) {
     return absInclude;
 }
 
-// parse some options from cli
-casper.options.verbose = casper.cli.get('direct') || false;
-casper.options.logLevel = casper.cli.get('log-level') || "error";
+function checkArgs() {
+    "use strict";
+    // parse some options from cli
+    casper.options.verbose = casper.cli.get('direct') || false;
+    casper.options.logLevel = casper.cli.get('log-level') || "error";
+    if (casper.cli.get('no-colors') === true) {
+        var cls = 'Dummy';
+        casper.options.colorizerType = cls;
+        casper.colorizer = colorizer.create(cls);
+    }
+    casper.test.options.failFast = casper.cli.get('fail-fast') || false;
 
-// overriding Casper.open to prefix all test urls
-casper.setFilter('open.location', function(location) {
-    if (!/^http/.test(location)) {
-        return f('file://%s/%s', fs.workingDirectory, location);
+    // test paths are passed as args
+    if (casper.cli.args.length) {
+        tests = casper.cli.args.filter(function(path) {
+            if (fs.isFile(path) || fs.isDirectory(path)) {
+                return true;
+            }
+            throw new CasperError(f("Invalid test path: %s", path));
+        });
+    } else {
+        casper.echo('No test path passed, exiting.', 'RED_BAR', 80);
+        casper.exit(1);
     }
-    return location;
-});
 
-// test paths are passed as args
-if (casper.cli.args.length) {
-    tests = casper.cli.args.filter(function(path) {
-        return fs.isFile(path) || fs.isDirectory(path);
-    });
-} else {
-    casper.echo('No test path passed, exiting.', 'RED_BAR', 80);
-    casper.exit(1);
+    // check for casper selftests
+    if (!phantom.casperSelfTest && checkSelfTest(tests)) {
+        casper.warn('To run casper self tests, use the `selftest` command.');
+        casper.exit(1);
+    }
 }
 
-// includes handling
-if (casper.cli.has('includes')) {
-    includes = casper.cli.get('includes').split(',').map(function(include) {
-        // we can't use filter() directly because of abspath transformation
-        return checkIncludeFile(include);
-    }).filter(function(include) {
-        return utils.isString(include);
+function initRunner() {
+    "use strict";
+    // includes handling
+    loadIncludes.forEach(function(include){
+        var container;
+        if (casper.cli.has(include)) {
+            container = casper.cli.get(include).split(',').map(function(file) {
+                return checkIncludeFile(file);
+            }).filter(function(file) {
+                return utils.isString(file);
+            });
+            casper.test.loadIncludes[include] = utils.unique(container);
+        }
+    });
+
+    // test suites completion listener
+    casper.test.on('tests.complete', function() {
+        this.renderResults(true, undefined, casper.cli.get('xunit') || undefined);
+        if (this.options.failFast && this.testResults.failures.length > 0) {
+            casper.warn('Test suite failed fast, all tests may not have been executed.');
+        }
     });
-    casper.test.includes = utils.unique(includes);
 }
 
-// test suites completion listener
-casper.test.on('tests.complete', function() {
-    this.renderResults(true, undefined, casper.cli.get('xunit') || undefined);
-});
+var error;
+try {
+    checkArgs();
+} catch (e) {
+    error = true;
+    casper.warn(e);
+    casper.exit(1);
+}
 
-// run all the suites
-casper.test.runSuites.apply(casper.test, tests);
+if (!error) {
+    initRunner();
+    casper.test.runSuites.apply(casper.test, tests);
+}