您好, 欢迎来到 !    登录 | 注册 | | 设为首页 | 收藏本站

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 形式。


联系我
置顶