logo标签列表

每当我运行gulp anything时，都会出现一个断言错误。- 必须指定任务函数

gulpgulp-watch
182

我试图运行下面的命令，但不幸遇到了错误。

$ gulp build

在我的终端中，我遇到了这个断言错误。 我已经使用Homebrew卸载了node和NPM，然后按照此链接中提供的步骤重新安装 - 如何完全卸载Node.js并从头重新安装（Mac OS X）。 我的Node版本是v10.5.0，npm版本是6.1.0。

我的系统是MacOS High Sierra 10.13.2

assert.js:269
    throw err;
    ^

AssertionError [ERR_ASSERTION]: Task function must be specified
    at Gulp.set [as _setTask] (bulkit/startup-kit/node_modules/undertaker/lib/set-task.js:10:3)
    at Gulp.task (startup-kit/node_modules/undertaker/lib/task.js:13:8)
    at Object.<anonymous> 
    at Module._compile (internal/modules/cjs/loader.js:702:30)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:713:10)
    at Module.load (internal/modules/cjs/loader.js:612:32)
    at tryModuleLoad (internal/modules/cjs/loader.js:551:12)
    at Function.Module._load (internal/modules/cjs/loader.js:543:3)
    at Module.require (internal/modules/cjs/loader.js:650:17)
    at require (internal/modules/cjs/helpers.js:20:18)

package.json

{
    "name": "bulkit-startup",
    "version": "0.0.1",
    "description": "Bulkit Startup Kit",
    "main": "Gruntfile.js",
    "devDependencies": {
        "autoprefixer": "^6.3.6",
        "browser-sync": "^2.24.5",
        "gulp": "^4.0.0",
        "gulp-clean": "^0.3.2",
        "gulp-concat": "^2.6.0",
        "gulp-postcss": "^6.1.0",
        "gulp-sass": "^2.2.0",
        "gulp-sourcemaps": "^1.6.0",
        "jquery": "^3.3.1",
        "mq4-hover-shim": "^0.3.0",
        "panini": "^1.3.0",
        "rimraf": "^2.5.2"
    },
    "engines": {
        "node": ">=0.10.1"
    },
    "scripts": {
        "start": "gulp",
        "build": "gulp build"
    },
    "repository": {
        "type": "git",
        "url": "https://github.com/cssninjaStudio/bulkit.git"
    },
    "bugs": {
        "url": "https://github.com/cssninjaStudio/bulkit/issues",
        "email": "support@cssninja.io"
    },
    "author": "Css Ninja <hello@cssninja.io> (https://cssninja.io/themes/bulkit)",
    "license": "Commercial",
    "private": true,
    "dependencies": {
        "bulma": "^0.7.0",
        "del": "^3.0.0",
        "jquery-waypoints": "^2.0.5",
        "jquery.counterup": "^2.1.0",
        "scrollreveal": "^3.4.0",
        "slick-carousel": "^1.8.1",
        "wallop": "^2.4.1"
    }
}

gulpfile.js

var gulp = require('gulp');
var clean = require('gulp-clean');
var sass = require('gulp-sass');
var sourcemaps = require('gulp-sourcemaps');
var postcss = require('gulp-postcss');
var autoprefixer = require('autoprefixer');
var mq4HoverShim = require('mq4-hover-shim');
var rimraf = require('rimraf').sync;
var browser = require('browser-sync');
var panini = require('panini');
var concat = require('gulp-concat');
var port = process.env.SERVER_PORT || 8080;
var nodepath =  'node_modules/';
var assetspath =  'assets/';

// Starts a BrowerSync instance
gulp.task('server', ['build'], function(){
    browser.init({server: './_site', port: port});
});

// Watch files for changes
gulp.task('watch', function() {
    gulp.watch('scss/**/*', ['compile-scss', browser.reload]);
    gulp.watch('sass/**/*', ['compile-sass', browser.reload]);
    gulp.watch('js/**/*', ['copy-js', browser.reload]);
    gulp.watch('images/**/*', ['copy-images', browser.reload]);
    gulp.watch('html/pages/**/*', ['compile-html']);
    gulp.watch(['html/{layouts,includes,helpers,data}/**/*'], ['compile-html:reset','compile-html']);
    gulp.watch(['./src/{layouts,partials,helpers,data}/**/*'], [panini.refresh]);
});

// Erases the dist folder
gulp.task('reset', function() {
    rimraf('bulma/*');
    rimraf('scss/*');
    rimraf('assets/css/*');
    rimraf('assets/fonts/*');
    rimraf('images/*');
});

// Erases the dist folder
gulp.task('clean', function() {
    rimraf('_site');
});

// Copy Bulma filed into Bulma development folder
gulp.task('setupBulma', function() {
    //Get Bulma from node modules
    gulp.src([nodepath + 'bulma/*.sass']).pipe(gulp.dest('bulma/'));
    gulp.src([nodepath + 'bulma/**/*.sass']).pipe(gulp.dest('bulma/'));
});

// Copy static assets
gulp.task('copy', function() {
    //Copy other external font and data assets
    gulp.src(['assets/fonts/**/*']).pipe(gulp.dest('_site/assets/fonts/'));
    gulp.src([nodepath + 'slick-carousel/slick/fonts/**/*']).pipe(gulp.dest('_site/assets/css/fonts/'));
    gulp.src([nodepath + 'slick-carousel/slick/ajax-loader.gif']).pipe(gulp.dest('_site/assets/css/'));
});

//Theme Sass variables
var sassOptions = {
    errLogToConsole: true,
    outputStyle: 'compressed',
    includePaths: [nodepath + 'bulma/sass']
};

//Theme Scss variables
var scssOptions = {
    errLogToConsole: true,
    outputStyle: 'compressed',
    includePaths: ['./scss/partials']
};

// Compile Bulma Sass
gulp.task('compile-sass', function () {
    var processors = [
        mq4HoverShim.postprocessorFor({ hoverSelectorPrefix: '.is-true-hover ' }),
        autoprefixer({
            browsers: [
                "Chrome >= 45",
                "Firefox ESR",
                "Edge >= 12",
                "Explorer >= 10",
                "iOS >= 9",
                "Safari >= 9",
                "Android >= 4.4",
                "Opera >= 30"
            ]
        })//,
        //cssnano(),
    ];
    //Watch me get Sassy
    return gulp.src('./bulma/bulma.sass')
        .pipe(sourcemaps.init())
        .pipe(sass(sassOptions).on('error', sass.logError))
        .pipe(postcss(processors))
        .pipe(sourcemaps.write())
        .pipe(gulp.dest('./_site/assets/css/'));
});

// Compile Theme Scss
gulp.task('compile-scss', function () {
    var processors = [
        mq4HoverShim.postprocessorFor({ hoverSelectorPrefix: '.is-true-hover ' }),
        autoprefixer({
            browsers: [
                "Chrome >= 45",
                "Firefox ESR",
                "Edge >= 12",
                "Explorer >= 10",
                "iOS >= 9",
                "Safari >= 9",
                "Android >= 4.4",
                "Opera >= 30"
            ]
        })//,
        //cssnano(),
    ];
    //Watch me get Sassy
    return gulp.src('./scss/core.scss')
        .pipe(sourcemaps.init())
        .pipe(sass(sassOptions).on('error', sass.logError))
        .pipe(postcss(processors))
        .pipe(sourcemaps.write())
        .pipe(gulp.dest('./_site/assets/css/'));
});

// Compile Html
gulp.task('compile-html', function() {
    gulp.src('html/pages/**/*.html')
        .pipe(panini({
        root: 'html/pages/',
        layouts: 'html/layouts/',
        partials: 'html/includes/',
        helpers: 'html/helpers/',
        data: 'html/data/'
    }))
        .pipe(gulp.dest('_site'))
        .on('finish', browser.reload);
});

gulp.task('compile-html:reset', function(done) {
    panini.refresh();
    done();
});

// Compile css from node modules
gulp.task('compile-css', function() {
    return gulp.src([ 
        nodepath + 'slick-carousel/slick/slick.css',
        nodepath + 'slick-carousel/slick/slick-theme.css',
        nodepath + 'wallop/css/wallop.css',
        //Additional static css assets
        assetspath + 'css/icons.min.css',
    ])
        .pipe(concat('app.css'))
        .pipe(gulp.dest('./_site/assets/css/'));
});

// Compile js from node modules
gulp.task('compile-js', function() {
    return gulp.src([ 
        nodepath + 'jquery/dist/jquery.min.js', 
        nodepath + 'slick-carousel/slick/slick.min.js', 
        nodepath + 'scrollreveal/dist/scrollreveal.min.js',
        nodepath + 'waypoints/lib/jquery.waypoints.min.js',
        nodepath + 'waypoints/lib/shortcuts/sticky.min.js',
        nodepath + 'jquery.counterup/jquery.counterup.min.js',
        nodepath + 'wallop/js/Wallop.min.js',
        //Additional static js assets
        assetspath + 'js/ggpopover/ggpopover.min.js',
        assetspath + 'js/ggpopover/ggtooltip.js',
        assetspath + 'js/embed/embed.js',
        assetspath + 'js/gmap/gmap.min.js',
    ])
        .pipe(concat('app.js'))
        .pipe(gulp.dest('./_site/assets/js/'));
});

//Copy Theme js to production site
gulp.task('copy-js', function() {
    gulp.src('js/**/*.js')
        .pipe(gulp.dest('./_site/assets/js/'));
});

//Copy images to production site
gulp.task('copy-images', function() {
    gulp.src('images/**/*')
        .pipe(gulp.dest('./_site/assets/images/'));
});

gulp.task('init', ['setupBulma']);
gulp.task('build', ['clean','copy', 'compile-js', 'compile-css', 'copy-js', 'compile-sass', 'compile-scss', 'compile-html', 'copy-images']);
gulp.task('default', ['server', 'watch']);
13个回答
264

Gulp 4.0更新了任务定义的方式，如果一个任务需要依赖另一个任务来执行，则不再使用list参数。该参数已被弃用。

您的gulpfile.js中的示例代码如下：

// Starts a BrowerSync instance
gulp.task('server', ['build'], function(){
  browser.init({server: './_site', port: port});
});

他们引入了gulp.series()和gulp.parallel()，取代了列表参数。

应该将此任务更改为以下内容：

// Starts a BrowerSync instance
gulp.task('server', gulp.series('build', function(){
  browser.init({server: './_site', port: port});
}));

我不是这方面的专家。您可以在gulp文档中关于串行运行任务的示例中找到更加完整的示例，或者参考Jhey Thompkins和Stefan Baumgartner所撰写的以下博客：

https://codeburst.io/switching-to-gulp-4-0-271ae63530c0

https://fettblog.eu/gulp-4-parallel-and-series/

8
这使我的错误从“必须指定任务”变为“任务未定义”。 - 2540625
1
@2540625 希望你最终解决了这个问题，但我之前也遇到了同样的问题，直到我将 gulp.task 的定义与 series() / parallel() 调用放在那里命名任务的定义 下面。这似乎是经典的 JavaScript 错误，尝试在定义之前使用函数。 - Jon
@Jon 这正是我遇到的情况，我将任务序列定义移动到定义任务的部分下面，然后就可以了（在v3中这不是问题）。 - HMZ
@2540625 我把这个任务移动到了与默认任务定义在同一个文件中（在它之前），问题得到了解决，所以这是一些加载顺序的问题。 - OZZIE
125

尝试替换您的 gulpfile.js 文件的最后一行。

gulp.task('default', ['server', 'watch']);

与

gulp.task('default', gulp.series('server', 'watch'));
没有区别 - Robert Carmichael
没有区别 - undefined
24
在package.json文件中将gulp版本降低到3.9.1。
"gulp": "^3.9.1",
11
如果你的Node版本是v10，请不要这样做。 - bbsimonbb
1
@bbsimonbb，你能详细说明一下吗？ - Yves Calaci
4
Henri的第四个版本更改了任务运行方式，因此要使他的当前代码能够运行，他需要运行gulp 3.9.1。但更好的答案是更新他的代码以兼容gulp 4+。 - user441058
21
你不需要将gulp降级到`gulp 4`，使用`gulp.series()`来组合多个任务。首先使用以下命令全局安装gulp：
```npm install --global gulp-cli```
然后在你的工作目录中本地安装gulp：
```npm install --save-dev gulp``` 详细信息请参见此处 示例： package.json
{
  "name": "gulp-test",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "browser-sync": "^2.26.3",
    "gulp": "^4.0.0",
    "gulp-sass": "^4.0.2"
  },
  "dependencies": {
    "bootstrap": "^4.3.1",
    "jquery": "^3.3.1",
    "popper.js": "^1.14.7"
  }
}

gulpfile.js

var gulp = require("gulp");
var sass = require('gulp-sass');
var browserSync = require('browser-sync').create();

// Specific Task
function js() {
    return gulp
    .src(['node_modules/bootstrap/dist/js/bootstrap.min.js', 'node_modules/jquery/dist/jquery.min.js', 'node_modules/popper.js/dist/umd/popper.min.js'])
    .pipe(gulp.dest('src/js'))
    .pipe(browserSync.stream());
}
gulp.task(js);

// Specific Task
function gulpSass() {
    return gulp
    .src(['src/scss/*.scss'])
    .pipe(sass())
    .pipe(gulp.dest('src/css'))
    .pipe(browserSync.stream());
}
gulp.task(gulpSass);

// Run multiple tasks
gulp.task('start', gulp.series(js, gulpSass));
运行gulp start以启动多个任务，并运行gulp js或gulp gulpSass以执行特定任务。
1
这已经足够接近了。我不得不查看Gulp网站以获取正确的语法并添加导出。 - Luke Puplett
12

https://fettblog.eu/gulp-4-parallel-and-series/

由于gulp.task(name, deps, func)被替换为gulp.task(name, gulp.{series|parallel}(deps, func))。

您正在使用最新版本的gulp，但使用了旧代码。请修改代码或降级使用旧版gulp。

10

当我使用Gulp时，遇到了同样的错误。解决方法是切换到版本为3.9.1的Gulp，包括本地版本和CLI版本。

sudo npm install -g gulp@3.9.1

在项目文件夹中运行

npm install gulp@3.9.1
10

问题在于您正在使用gulp 4，而gulfile.js中的语法是gulp 3的语法。因此，要么将gulp降级到3.x.x版本，要么使用gulp 4的语法。

语法Gulp 3：

gulp.task('default', ['sass'], function() {....} );

Gulp 4 的语法：

gulp.task('default', gulp.series(sass), function() {....} );

你可以在以下网址中了解更多有关gulp和gulp任务的信息: https://medium.com/@sudoanushil/how-to-write-gulp-tasks-ce1b1b7a7e81

6

在从Gulp 3.x迁移到Gulp 4.x时，我们经常遇到以下常见错误：

错误：

  • AssertionError [ERR_ASSERTION]: 必须指定任务函数
  • AssertionError [ERR_ASSERTION]: 未定义任务：
  • 以下任务未完成：是否忘记信号异步完成？

以下是关于任务定义和执行需要注意的几点：

  1. 首先定义任务
  2. 使用return语句
  3. 然后使用gulp.series()执行

这里是与Gulp v4一起使用的快速Gulp代码：

// First define task with Return
gulp.task('css-minify', function () {
    return gulp.src('assets/images/*.*')
        .pipe(smushit({verbose: true}))
        .pipe(gulp.dest('assets/images'));
});

// Then execute task with bracket '()' instead of '[]'
gulp.task('default', gulp.series('css-minify'));
6

将数组替换为：

gulp.task('default', ['task1', 'task2','task3']);

使用gulp.series()函数

gulp.task('default', gulp.series('task1', 'task2','task3'));
1
您介意详细说明一下这与此答案有何不同吗？ - Patrick Yoder
4

频繁更改gulp和npm版本以解决错误不是一个好习惯。最近重新安装我的工作机后，我遇到了许多异常情况，浪费了大量时间进行重新安装和修复。

因此，我决定将所有内容升级到最新版本：

npm -v : v12.13.0 
node -v : 6.13.0
gulp -v : CLI version: 2.2.0 Local version: 4.0.2

这个错误是由于gulpfile中的编码方式导致的，而不是版本不匹配造成的。

所以，在这里你需要更改gulpfile中的两个内容，以便与Gulp4版本对齐。

Gulp4已经改变了如何启动任务，不同于版本3。

  1. 在版本4中，您必须将任务定义为函数，然后使用它的字符串名称将其调用为gulp任务。在V3中：

gulp.task（'serve'，['sass']，function（）{...}）;

但在V4中应该像这样：

function serve() {
...
}
gulp.task('serve', gulp.series(sass));
  1. 如@Arthur所述，您需要更改将参数传递到任务函数的方式。 在V3中是这样的：

gulp.task('serve', ['sass'], function() { ... });

但在V4中，应该是：

gulp.task('serve', gulp.series(sass));
网页内容由stack overflow 提供, 点击上面的
可以查看英文原文，
原文链接