6.1 KiB
Node.js 的API文档
Node.js 的API文档(英文): https://nodejs.org/docs/latest-v8.x/api/index.html
Node.js 的API文档(中文):http://nodejs.cn/api/
查阅文档时,稳定指数如下:
-
红色:废弃。
-
橙色:实验。表示当前版本可用,其他版本不确定。也许不向下兼容,建议不要在生产环境中使用该特性。
-
绿色:稳定。与 npm 生态系统的兼容性是最高的优先级。
Node.js 中模块的分类
Node.js 应用由模块组成,采用 CommonJS 模块规范。Node.js中的模块分为三种:
-
内置模块
-
第三方模块
-
自定义模块
下面简单介绍一下。
1、内置模块
const process = require('process');
const path = require('path');
console.log(process.version);
console.log(path.resolve('../'));
require方法用于加载模块。
2、require 加载第三方包的机制
const express = require('express');
require 加载第三方包的机制:
(1)第三方包安装好后,这个包一般会存放在当前项目的 node_modules 文件夹中。我们找到这个包的 package.json 文件,并且找到里面的main属性对应的入口模块,这个入口模块就是这个包的入口文件。
(2)如果第三方包中没有找到package.json文件,或者package.json文件中没有main属性,则默认加载第三方包中的index.js文件。
(3)如果在 node_modules 文件夹中没有找到这个包,或者以上所有情况都没有找到,则会向上一级父级目录下查找node_modules文件夹,查找规则如上一致。
(4)如果一直找到该模块的磁盘根路径都没有找到,则会报错:can not find module xxx。
3、自定义模块(module):
每个文件就是一个模块,有自己的作用域。在一个文件里面定义的变量、函数、类,都是私有的,对其他文件不可见。
举例:
var example = require('./example.js');
console.log(example.x); // 5
console.log(example.addX(1)); // 6
今天这篇文章,重点讲一下 Node 内置模块中的 fs 文件处理模块。
在使用文件模块之前,记得先导入:
// 导入文件模块
const fs = require('fs');
文件读取
fs 的英文全称是 File System。fs 模块提供了很多api方法,我们首先应该学习的方法是文件读取。
Node中文件读取的方式主要有以下几种。
异步读取文件 fs.readFile()
语法格式:
fs.readFile(file[, options], callback(error, data))
代码举例:
const fs = require('fs');
fs.readFile('hello.txt', 'utf8', (err, data) => {
if (err) {
// 失败
console.log(err)
} else {
// 成功
console.log('异步读取数据:' + data2)
}
});
如果需要嵌套读取多个文件,可以用 promise 或者 async ... await 进行封装。代码举例如下。
promise 封装 fs.readFile()
const fs = require('fs');
function fsRead(path) {
return new Promise((resolve, reject) => {
fs.readFile(path, { flag: 'r', encoding: "utf-8" }, (err, data) => {
if (err) {
//失败执行的内容
reject(err)
} else {
//成功执行的内容
resolve(data)
}
})
})
}
var promise1 = fsRead('hello1.txt')
promise1.then(res1 => {
console.log(res1);
return fsRead('hello2.txt');
}).then(res2 => {
console.log(res2);
return fsRead('hello3.txt');
}).then(res3 => {
console.log(res);
})
async ... await 封装 fs.readFile()
这个写法更为简洁,推荐。
var fs = require('fs');
function fsRead(path) {
return new Promise((resolve, reject) => {
fs.readFile(path, { flag: 'r', encoding: "utf-8" }, (err, data) => {
if (err) {
//失败执行的内容
reject(err)
} else {
//成功执行的内容
resolve(data)
}
})
})
}
async function ReadList() {
var res1 = await fsRead('hello1.txt');
var res2 = await fsRead('hello2.txt');
var res3 = await fsRead('hello3.txt');
}
// 执行方法
ReadList();
同步读取文件 fs.readFileSync()
语法格式:
fs.readFileSync(file[, options])
代码举例:
const fs = require('fs');
try {
const data = fs.readFileSync('hello.txt', 'utf8');
console.log(data);
} catch(e) {
// 文件不存在,或者权限错误
throw e;
}
Node.js 中的同步和异步的区别
fs模块对文件的几乎所有操作都有同步和异步两种形式。例如:readFile() 和 readFileSync()。
区别:
-
同步调用会阻塞代码的执行,异步则不会。
-
异步调用会将 读取任务 下达到任务队列,直到任务执行完成才会回调。
-
异常处理方面,同步必须使用 try catch 方式,异步可以通过回调函数的第一个参数。【重要】
文件写入
语法格式:
fs.write(fd, string[, position[, encoding]], callback)
async ... await 封装:
let fs = require('fs')
function writeFs(path, content) {
return new Promise(function (resolve, reject) {
fs.writeFile(path, content, { flag: "a", encoding: "utf-8" }, function (err) {
if (err) {
//console.log("写入内容出错")
reject(err)
} else {
resolve(err)
//console.log("写入内容成功")
}
})
})
}
async function writeList() {
await writeFs('1.html', "<h1>qianguyihao</h1>");
await writeFs('2.html', "<h1>hello world</h1>");
await writeFs('3.html', "<h1>永不止步</h1>");
}
writeList()
删除文件
语法格式:
fs.unlink(path, callback)
参数说明:
- path:文件路径。
- callback:回调函数。
代码举例:
fs.unlink('path/file.txt', (err) => {
if (err) throw err;
console.log('文件删除成功');
});
备注:fs.unlink()
不能用于目录。 要删除目录,则使用 fs.rmdir()
。