【编者按】本文作者为来自 MongoDB 的 NodeJS 工程师 Valeri Karpov。Valeri 专注于维护常见的 Mongoose ODM,是《Professional AngularJS》一书的作者。本文由 OneAPM 工程师编译呈现,以下为正文。
大多数Node.js 开发人员都将npm用做包管理器。然而,npm同样也是一个强大的task runner,能够代替gulp。npm run命令让你在package.jso上定义客制化脚本,这样一来就简化了复杂的与节点相关的 shell脚本,使其变成单行。笔者将在本文讲述常见的npm run使用案例,包括使用npm run,通过Babel和Browserify输入ES6浏览器代码。
设置环境变量和标志
Node.js有几个方便的配置选项,使用环境变量和命令行标志(比如过去用来启用0.12.x版中ES2015特性的古老的harmony标志)就可以设置。npm run命令,尤其是npm start指令,可以让你在运行前设置任何应用所需的标志。
比如说, NODE_PATH 环境变量能让你在require()函数的模块搜索路径上添加额外目录。换句话说,如果你的项目中有一个包含源代码的lib目录和一个包含测试代码的test目录。并且,你在test/e2e/my_feature/my_feature.test.js中有个测试,试图require()某个声明在lib/server/my_feature/utils.js中的函数。这就会涉及脆弱的require(‘../../../lib/server/my_feature_utils’)命令。每次目录更改时,该命令便会中断。然而,如果你运行 env NODE_PATH=./ node test/e2e/my_feature/my_feature.test.js, require()便知道查看当前目录。这样就可以 用require(‘lib/server/my_feature/utils’)进行替代。
遗憾的是,你设置的每一个环境变量和标志都会额外增加启动应用的复杂性。可以确定的是,如果你需要设置17个环境变量和标志来启动应用,肯定会遗漏一两个。如果你的应用依赖于 env NODE_PATH=./和ES2015 proxies(后者直到本文写稿时,仍隐藏在–harmony_proxies标志后)。那么,你可以按照下文所示,在.json包文件中定义一个 start脚本:
{
"scripts": {
"start": "env NODE_PATH=./ node --harmony_proxies index.js" } }
现在,如果运行npm start(npm run start的简称),npm会运行start脚本,启动带有特殊配置选项的应用。
命令行快捷键
我们知道,让用户运行 npm install –g非常麻烦。或许,你已经听说,即将面世的gulp4.0与gulp3.x.完全不兼容。由于全球有许多人安装了gulp,因此package.json没有办法强制遍布全球的软件包,所以,许多用户将不得不面临选择:到底要哪一个版本的gulp。
在package.json中将gulp列作devDependency会好很多,但是,之后你就必须运行/node_modules/.bin/gulp watch而并非gulp watch,这样十分麻烦。这就是npm run大展身手的地方了。它能将 /node_modules/.bin 加到你的PATH中。换句话说,如果你把gulp3.8列作 devDependency,就能访问package.json脚本上的gulp可执行文件,而不需要用户运行npm install gulp –g。
{
"scripts": {
"watch": "gulp watch" }}
现在,npm run watch 是/node_modules/.bin/gulp watch的快捷方式。使用mocha也可以达到同样的效果。
{
"scripts": {
"test": "mocha -r nyan test/*.test.js" } }
现在,npm test(和npm run test一样)是在test目录中使用nyan cat指示器运行所有mocha测试的快捷方式。
Mocha可执行文件同样也有一些简洁的命令行标志。比如说,grep (简称 -g )mocha标志让你只运行名称和给定正则表达式匹配的测试。在npm >= 2.14.0中,你可以使用 – 传输其他标志为mocha。例如,下面的命令作用是相同的。
# This command... npm test -- -g "login.fails" # is the same thing as this one /node_modules/.bin/mocha -r nyan test/.test.js -g "login.*fails"
gulp的备选方案
作为强大的流构建系统,gulp能够让你并行化编译文件。这是一个很棒的工具,但是,对于某些应用程序,可能有点大材小用,尤其当你的团队不太了解Node.js流时。在许多情况下,npm run指令可以作为性能较温和的gulp替代物。举个例子来说,假如在example.js中有一些ES2015代码,你想通过babel transpile,之后导入browserify ,在浏览器中使用。
'use strict'; const co = require('co')
/node_modules/.bin/mocha -r nyan test/.test.js -g "login.fails"
co(function*() {
console.log('Hello, world!');
如果想用gulp进行编译,你可能会用到gulp-babel和gulp-browserify npm两种模型,为gulp包装babel和browserify。然而,babel和browserify有命令行界面,因此你可以使用Unix-style pipes编译这一文件。注意,下面的例子要求使用babel 5.x,不适用于babel 6.
'use strict'; /node_modules/.bin/browserify example.js | ./node_modules/.bin/babel > ./bin/example.js
再说一次,/node_modules/.bin这部分很讨人厌。值得庆幸的是,如果你在package.json中定义编译脚本,使用 npm run编译也能够取得同样的效果。
{ "scripts": { "compile": "browserify example.js | babel > ./bin/example.js}
}
文末思考
npm run指令让npm成为多功能的task runner,而不只是任务管理器。好的node.js应用凭借npm start和 npm test明确了如何运行应用以及如何测验。同样,npm run 让可执行npm模块(gulp、mocha、karma等)用作devDependencies更加方便。你甚至可以借助 npm run和Unix流来运行构建程序,无需gulp或者grunt等构建系统的帮助。从概念上讲,npm run 与package.json 中的scripts部分应该定义如何为你的应用完成最常见的指令行任务,如启动应用、检测和运行各种transpilers。
本文转自 OneAPM 官方博客
原文地址:https://strongloop.com/strongblog/3-neat-tricks-with-npm-run/