grunt.config
从 Gruntfile 中针对当前项目的配置数据。
注意,任何为 ? (unicode sman) 的也是可以直接通过 grunt 对象访问的;任何为 ☆ (white star) 的都可以在task内部通过 this 对象访问的。请知晓。
初始化配置数据
注意,下面列出的也可以通过 grunt 对象访问,访问形式为 grunt.initCon。
为当前项目初始化配置对象。其中传入的 conObject 参数可以用在后续的task中,可以通过grunt.con 访问。几乎每个项目的 Gruntfile 都会此。
grunt.con.init(conObject)
注意,任何 <% %> 模板字符串只会在取到配置数据后才被处理。
下面的案例展示了针对 中的 jshint task的配置数据:
grunt.con.init({ jshint: { all: ['lib/*.js', 'test/*.js', 'Gruntfile.js'] } });
查看 Getting started 指南可以更多的配置案例。
此还可以以 grunt.initCon 的形式访问。
配置数据
以下允许通过点分隔的字符串'pkg.author.name'或通过部分的数组来访问Grunt配置数据['pkg', 'author', 'name']。
请注意,如果指定的包含.点,则必须使用反斜杠对其进行转义,例如。'concat.dist/built\\.js'。如果指定了零件数组,Grunt将使用该grunt.con.escape在内部处理转义。
从项目的 Grunt 配置中或者设置值。这个作为其他的别名;如果传递两个参数,grunt.con.set被,另一方面grunt.con.get也被。
grunt.con([prop [, value]])
从项目的Grunt配置中值。如果prop指定,则返回该的值,或者null未定义该。如果prop未指定,则返回整个配置对象的副本。将使用该grunt.con.process递归处理模板字符串。
grunt.con.get([prop])
处理值,在遇到 Grunt 配置的上下文中递归扩展<% %>模板(通过grunt.template.process)。此由,grunt.con.get但不是由grunt.con.getRaw。
grunt.con.process(value)
如果任何检索的值完全是单个'<%= foo %>'或'<%= foo.bar %>'模板字符串,并且指定的foo或foo.bar是非字符串(而不是null或undefined)值,则它将扩展为实际值。这与 grunt 的任务系统展平数组相结合,非常有用。
从项目的Grunt配置中原始值,而无需处理<% %>模板字符串。如果prop指定,则返回该的值,或者null未定义该。如果prop未指定,则返回整个配置对象的副本。
grunt.con.getRaw([prop])
给当前项目的 Grunt 配置中的某个设置值。
grunt.con.set(prop, value)
注意,任何 <% %> 模板字符串只会在取到配置数据后才被处理。
忽略给定的propString中的.点号。这应该用于包含点号的名。除了 给定的propString中的. 点,这应该用于包含点的。
grunt.con.escape(propString)
Added in 0.4.5
递归地将指定的合并conObject到当前项目配置中。以递归方式合并数组和普通对象,同时覆盖其他值类型。
grunt.con.merge(conObject)
您可以使用此将配置选项,目标等附加到已定义的任务,例如:
grunt.con.merge({ watch: { files: ["path/to/files"], tasks: ["task"] } });
数组值根据其索引进行合并。请考虑以下:
grunt.initCon({ jshint: { files: ['Gruntfile.js', 'src/**/*.js'], });var con = { jshint: { files: ['hello.js'], }};grunt.con.merge(con);
它将导致如下所示的配置:
jshint: { files: ['hello.js', 'src/**/*.js'],}
总之,variable()中files定义的数组的第值会覆盖配置call()中指定的第值。conhello.jsinitConGruntfile.js
需要配置数据
注意,下面列出的都可以在task内部通过 this 对象访问,访问形式为 this.requiresCon。
如果需要的配置有或多个不存在、值为null 或 undefined,当前task将失败。此可以指定或多个字符串、配置数组作为参数。
grunt.con.requires(prop [, prop [, ...]])
此在task内部以 this.requiresCon 形式。