Node.js 常用工具

简介: Node.js 常用工具

util 是一个Node.js 核心模块,提供常用函数的集合,用于弥补核心 JavaScript 的功能 过于精简的不足。

使用方法如下:

const util = require('util');


util.callbackify

util.callbackify(original)async 异步函数(或者一个返回值为 Promise 的函数)转换成遵循异常优先的回调风格的函数,例如将 (err, value) => ... 回调作为最后一个参数。 在回调函数中,第一个参数为拒绝的原因(如果 Promise 解决,则为 null),第二个参数则是解决的值。

实例

const util = require('util');


async function fn() {

 return 'hello world';

}

const callbackFunction = util.callbackify(fn);


callbackFunction((err, ret) => {

 if (err) throw err;

 console.log(ret);

});

以上代码输出结果为:

hello world

回调函数是异步执行的,并且有异常堆栈错误追踪。 如果回调函数抛出一个异常,进程会触发一个 'uncaughtException' 异常,如果没有被捕获,进程将会退出。

null 在回调函数中作为一个参数有其特殊的意义,如果回调函数的首个参数为 Promise 拒绝的原因且带有返回值,且值可以转换成布尔值 false,这个值会被封装在 Error 对象里,可以通过属性 reason 获取。

function fn() {

 return Promise.reject(null);

}

const callbackFunction = util.callbackify(fn);


callbackFunction((err, ret) => {

 // 当 Promise 被以 `null` 拒绝时,它被包装为 Error 并且原始值存储在 `reason` 中。

 err && err.hasOwnProperty('reason') && err.reason === null;  // true

});

original 为 async 异步函数。该函数返回传统回调函数。


util.inherits

util.inherits(constructor, superConstructor) 是一个实现对象间原型继承的函数。

JavaScript 的面向对象特性是基于原型的,与常见的基于类的不同。JavaScript 没有提供对象继承的语言级别特性,而是通过原型复制来实现的。

在这里我们只介绍 util.inherits 的用法,示例如下:

var util = require('util'); 

function Base() { 

   this.name = 'base'; 

   this.base = 1991; 

   this.sayHello = function() { 

   console.log('Hello ' + this.name); 

   }; 

} 

Base.prototype.showName = function() { 

   console.log(this.name);

}; 

function Sub() { 

   this.name = 'sub'; 

} 

util.inherits(Sub, Base); 

var objBase = new Base(); 

objBase.showName(); 

objBase.sayHello(); 

console.log(objBase); 

var objSub = new Sub(); 

objSub.showName(); 

//objSub.sayHello();

console.log(objSub);

我们定义了一个基础对象 Base 和一个继承自 Base 的 Sub,Base 有三个在构造函数内定义的属性和一个原型中定义的函数,通过util.inherits 实现继承。运行结果如下:

base 

Hello base 

{ name: 'base', base: 1991, sayHello: [Function] } 

sub 

{ name: 'sub' }

注意:Sub 仅仅继承了Base 在原型中定义的函数,而构造函数内部创造的 base 属 性和 sayHello 函数都没有被 Sub 继承。

同时,在原型中定义的属性不会被 console.log 作 为对象的属性输出。如果我们去掉 objSub.sayHello(); 这行的注释,将会看到:

node.js:201 

throw e; // process.nextTick error, or 'error' event on first tick

^ 

TypeError: Object #<Sub> has no method 'sayHello'

at Object.<anonymous> (/home/byvoid/utilinherits.js:29:8) 

at Module._compile (module.js:441:26) 

at Object..js (module.js:459:10) 

at Module.load (module.js:348:31) 

at Function._load (module.js:308:12) 

at Array.0 (module.js:479:10) 

at EventEmitter._tickCallback (node.js:192:40)


util.inspect

util.inspect(object,[showHidden],[depth],[colors]) 是一个将任意对象转换 为字符串的方法,通常用于调试和错误输出。它至少接受一个参数 object,即要转换的对象。

showHidden 是一个可选参数,如果值为 true,将会输出更多隐藏信息。

depth 表示最大递归的层数,如果对象很复杂,你可以指定层数以控制输出信息的多 少。如果不指定depth,默认会递归 2 层,指定为 null 表示将不限递归层数完整遍历对象。 如果 colors 值为 true,输出格式将会以 ANSI 颜色编码,通常用于在终端显示更漂亮 的效果。

特别要指出的是,util.inspect 并不会简单地直接把对象转换为字符串,即使该对 象定义了 toString 方法也不会调用。

var util = require('util'); 

function Person() { 

   this.name = 'byvoid'; 

   this.toString = function() { 

   return this.name; 

   }; 

} 

var obj = new Person(); 

console.log(util.inspect(obj)); 

console.log(util.inspect(obj, true));

运行结果是:

Person { name: 'byvoid', toString: [Function] }

Person {

 name: 'byvoid',

 toString: 

  { [Function]

    [length]: 0,

    [name]: '',

    [arguments]: null,

    [caller]: null,

    [prototype]: { [constructor]: [Circular] } } }


util.isArray(object)

如果给定的参数 "object" 是一个数组返回 true,否则返回 false。

var util = require('util');


util.isArray([])

 // true

util.isArray(new Array)

 // true

util.isArray({})

 // false


util.isRegExp(object)

如果给定的参数 "object" 是一个正则表达式返回true,否则返回false。

var util = require('util');


util.isRegExp(/some regexp/)

 // true

util.isRegExp(new RegExp('another regexp'))

 // true

util.isRegExp({})

 // false


util.isDate(object)

如果给定的参数 "object" 是一个日期返回true,否则返回false。

var util = require('util');


util.isDate(new Date())

 // true

util.isDate(Date())

 // false (without 'new' returns a String)

util.isDate({})

 // false

更多详情可以访问 http://nodejs.org/api/util.html 了解详细内容。

目录
相关文章
|
7天前
|
数据可视化 前端开发 JavaScript
可视化工具D3.js
可视化工具D3.js
|
4天前
|
存储 JavaScript 前端开发
Node 版本控制工具 NVM 的安装和使用(Windows)
本文介绍了NVM(Node Version Manager)的Windows版本——NVM for Windows的安装和使用方法,包括如何安装Node.js的特定版本、列出已安装版本、切换使用不同版本的Node.js,以及其他常用命令,以实现在Windows系统上对Node.js版本的便捷管理。
Node 版本控制工具 NVM 的安装和使用(Windows)
|
5月前
|
JavaScript 前端开发 网络安全
【网络安全 | 信息收集】JS文件信息收集工具LinkFinder安装使用教程
【网络安全 | 信息收集】JS文件信息收集工具LinkFinder安装使用教程
241 4
|
16天前
|
JavaScript Linux 开发者
一个用于管理多个 Node.js 版本的安装和切换开源工具
【9月更文挑战第14天】nvm(Node Version Manager)是一个开源工具,用于便捷地管理多个 Node.js 版本。其特点包括:版本安装便捷,支持 LTS 和最新版本;版本切换简单,不影响开发流程;多平台支持,包括 Windows、macOS 和 Linux;社区活跃,持续更新。通过 nvm,开发者可以轻松安装、切换和管理不同项目的 Node.js 版本,提高开发效率。
|
3天前
|
C++
HTML+JavaScript构建一个将C/C++定义的ANSI字符串转换为MASM32定义的DWUniCode字符串的工具
HTML+JavaScript构建一个将C/C++定义的ANSI字符串转换为MASM32定义的DWUniCode字符串的工具
|
2月前
|
JavaScript 小程序 Java
【工具】用nvm管理nodejs版本切换,真香!
本文详细介绍了如何使用 nvm(node.js 版本管理工具)解决在不同项目间频繁切换 Node.js 版本的问题。通过实例展示了 A、B 两个项目分别依赖 v14.19.1 和 v16.15.0 版本时的解决方案,并提供了 nvm 的下载、安装及常用命令等实用信息,帮助读者轻松管理 Node.js 版本。文章还包括了卸载已安装的 Node.js、配置环境变量等步骤,确保切换顺畅无阻。
61 0
【工具】用nvm管理nodejs版本切换,真香!
|
2月前
|
JavaScript IDE 前端开发
前端开发工具配置 nodejs & git & IDE
前端开发工具配置 nodejs & git & IDE
|
3月前
|
JavaScript 数据安全/隐私保护
node.js 命令行的命令注册和配置工具(最新版) commander.js 实用教程(含自研脚手架的创建流程)
node.js 命令行的命令注册和配置工具(最新版) commander.js 实用教程(含自研脚手架的创建流程)
99 0
|
3月前
|
JavaScript 数据安全/隐私保护 索引
node.js 命令行交互工具(最新版) inquirer.js 实用教程
node.js 命令行交互工具(最新版) inquirer.js 实用教程
119 0
|
3月前
|
开发工具 数据安全/隐私保护 git
为了方便项目打包,我用Node写了个git-tag工具
为了方便项目打包,我用Node写了个git-tag工具
55 0