使用命令行

CasperJS附带了位于cli模块中的PhantomJS解析器之上的内置命令行解析器。它将传递的参数公开为位置和命名选项。

Casper实例总是包含一个可以使用的cli属性来方便访问这些参数，因此您不用担心操作cli模块解析API。

我们来看看这个简单的casper脚本：

  1. var casper = require("casper").create();
  3. casper.echo("Casper CLI passed args:");
  4. require("utils").dump(casper.cli.args);
  6. casper.echo("Casper CLI passed options:");
  7. require("utils").dump(casper.cli.options);
  9. casper.exit();
提示

请注意这两个casper-path和cli选项，这些选项通过casperjs Python可执行文件传递给casper脚本。

运行结果：

  1. $ casperjs test.js arg1 arg2 arg3 --foo=bar --plop anotherarg
  2. Casper CLI passed args: [
  3.     "arg1",
  4.     "arg2",
  5.     "arg3",
  6.     "anotherarg"
  7. ]
  8. Casper CLI passed options: {
  9.     "casper-path": "/Users/niko/Sites/casperjs",
  10.     "cli": true,
  11.     "foo": "bar",
  12.     "plop": true
  13. }

获取，查询或删除参数：

  1. var casper = require("casper").create();
  2. casper.echo(casper.cli.has(0));
  3. casper.echo(casper.cli.get(0));
  4. casper.echo(casper.cli.has(3));
  5. casper.echo(casper.cli.get(3));
  6. casper.echo(casper.cli.has("foo"));
  7. casper.echo(casper.cli.get("foo"));
  8. casper.cli.drop("foo");
  9. casper.echo(casper.cli.has("foo"));
  10. casper.echo(casper.cli.get("foo"));
  11. casper.exit();

运行结果：

  1. $ casperjs test.js arg1 arg2 arg3 --foo=bar --plop anotherarg
  2. true
  3. arg1
  4. true
  5. anotherarg
  6. true
  7. bar
  8. false
  9. undefined
提示

您可能需要在Windows中包裹含有转义双引号的空格的选项。如：-foo = \“space bar \”。

提示

如果你想检查是否有任何参数或选项传递到你的脚本怎么办？ 你可以这样：

  1. // removing default options passed by the Python executable
  2. casper.cli.drop("cli");
  3. casper.cli.drop("casper-path");
  5. if (casper.cli.args.length === 0 && Object.keys(casper.cli.options).length === 0) {
  6.     casper.echo("No arg nor option passed").exit();
  7. }

casperjs 本地选项

版本1.1新增 casperjs命令行有3个可用参数：

  • --direct：将log信息输出在控制台中。
  • --log-level=[debug|info|warning|error] 设置log类别
  • --engine=[phantomjs|slimerjs] 选择你想使用的浏览器内核。CasperJS支持 PhantomJS（默认）使用的Webkit内核， 和 SlimerJS 使用的Gecko内核。

警告 在版本1.1及以后版本弃用 --direct选项已经重命名为--verbose，尽管--direct仍然可以使用，但我们建议你放弃使用它从而使用重命名之后的选项。

示例：

  1. $ casperjs --verbose --log-level=debug myscript.js

最后提醒，你仍然可以像运行PhantomJS的脚本一样使用PhantomJS的标准CLI选项来运行脚本。

  1. $ casperjs --web-security=no --cookies-file=/tmp/mycookies.txt myscript.js
提示

如果你想知道本地PhantomJS cli拥有哪些可用的选项，你可以运行phantomjs的--help命令， SlimerJS和PhantomJS的命令基本上相同。

原始参数值

版本1.0新增 在默认情况下，cli对象将处理每个传递的参数并将它们转换到适当的检测类型，看一个例子：

  1. var casper = require('casper').create();
  2. var utils = require('utils');
  4. utils.dump(casper.cli.get('foo'));
  6. casper.exit();

如你所见，01234567的值被转换成了Nember。

如果你使用参数的原始值，可以在cli对象中使用raw属性，它保存了传入参数的原始值：

  1. var casper = require('casper').create();
  2. var utils = require('utils');
  4. utils.dump(casper.cli.get('foo'));
  5. utils.dump(casper.cli.raw.get('foo'));
  7. casper.exit();

例子的用法：

  1. var casper = require('casper').create();
  2. var utils = require('utils');
  4. utils.dump(casper.cli.get('foo'));
  5. utils.dump(casper.cli.raw.get('foo'));
  7. casper.exit();

由于ECMA脚本对数字的限制，对于非常长的数字（超过17位），CasperJS会使用参数的原始值。更多信息