转载

有关npm rum的3个简洁技巧

【编者按】本文作者为来自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 助您轻松锁定Node.js 应用性能瓶颈，通过强大的Trace 记录逐层分析，直至锁定行级问题代码。以用户角度展示系统响应速度，以地域和浏览器维度统计用户使用情况。想阅读更多技术文章，请访问OneAPM 官方博客。

原文地址： https://strongloop.com/strongblog/3-neat-tricks-with-npm-run/

原文 http://blog.oneapm.com/oneapm-course/648.html

正文到此结束