Node.js v0.12.0API手册--文件系统

File System

Stability: 3 - Stable

文件系统模块是一个简单包装的标准 POSIX 文件 I/O 操作方法集。您可以通过调用require('fs')来获取该模块。文件系统模块中的所有方法均有异步和同步版本。

文件系统模块中的异步方法需要一个完成时的回调函数作为最后一个传入形参。 回调函数的构成由您调用的异步方法所决定，通常情况下回调函数的第一个形参为返回的错误信息。 如果异步操作执行正确并返回，该错误形参则为 null或者undefined。

如果您使用的是同步版本的操作方法，则一旦出现错误，会以通常的抛出错误的形式返回错误。 你可以用try/catch等语句来拦截错误并使程序继续进行。

这里是一个异步版本的示例：

var fs = require('fs');

fs.unlink('/tmp/hello', function (err) {
  if (err) throw err;
  console.log('successfully deleted /tmp/hello');
});

这是同步版本的示例:

var fs = require('fs');

fs.unlinkSync('/tmp/hello')
console.log('successfully deleted /tmp/hello');

当使用异步方法时不能保证执行顺序,因此下面这个示例很容易出错:

fs.rename('/tmp/hello', '/tmp/world', function (err) {
  if (err) throw err;
  console.log('renamed complete');
});
fs.stat('/tmp/world', function (err, stats) {
  if (err) throw err;
  console.log('stats: ' + JSON.stringify(stats));
});

fs.stat有可能在fs.rename 前执行.要等到正确的执行顺序应该用下面的方法:

fs.rename('/tmp/hello', '/tmp/world', function (err) {
  if (err) throw err;
  fs.stat('/tmp/world', function (err, stats) {
    if (err) throw err;
    console.log('stats: ' + JSON.stringify(stats));
  });
});

在忙碌的任务进程中, 强烈推荐 使用这些函数的异步调用.同步版本会阻塞进程,直到完成处理,也就是说会暂停所有的连接。

可以使用文件名的相对路径, 但是记住这个路径是相对于process.cwd()的。

大部分的文件系统(fs)函数可以忽略回调函数(callback)这个参数.如果忽略它,将会由一个默认回调函数(callback)来重新抛出(rethrow)错误.要获得原调用点的堆栈跟踪(trace)信息,需要在环境变量里设置NODE_DEBUG.

$ cat script.js
function bad() {
  require('fs').readFile('/');
}
bad();

$ env NODE_DEBUG=fs node script.js
fs.js:66
        throw err;
              ^
Error: EISDIR, read
    at rethrow (fs.js:61:21)
    at maybeCallback (fs.js:79:42)
    at Object.fs.readFile (fs.js:153:18)
    at bad (/path/to/script.js:2:17)
    at Object.<anonymous> (/path/to/script.js:5:1)
    <etc.>

fs.rename(oldPath, newPath, callback)

异步版本的函数rename(2)。完成时的回调函数(callback)只接受一个参数:可能出现的异常信息。

fs.renameSync(oldPath, newPath)

同步版本的rename(2)。

fs.ftruncate(fd, len, callback)

异步版本的ftruncate(2)。完成时的回调函数(callback)只接受一个参数:可能出现的异常信息。

fs.ftruncateSync(fd, len)

同步版本的ftruncate(2)。

fs.truncate(path, len, callback)

异步版本的truncate(2)。完成时的回调函数(callback)只接受一个参数:可能出现的异常信息。

fs.truncateSync(path, len)

同步版本的truncate(2)。

fs.chown(path, uid, gid, callback)

异步版本的chown(2)。完成时的回调函数(callback)只接受一个参数:可能出现的异常信息。

fs.chownSync(path, uid, gid)

同步版本的chown(2)。

fs.fchown(fd, uid, gid, callback)

异步版本的fchown(2)。回调函数的参数除了出现错误时有一个错误对象外，没有其它参数。

fs.fchownSync(fd, uid, gid)

同步版本的fchown(2)。

fs.lchown(path, uid, gid, callback)

异步版的lchown(2)。完成时的回调函数(callback)只接受一个参数:可能出现的异常信息。

fs.lchownSync(path, uid, gid)

同步版本的lchown(2)。

fs.chmod(path, mode, callback)

异步版的 chmod(2)。完成时的回调函数(callback)只接受一个参数:可能出现的异常信息。

fs.chmodSync(path, mode)

同步版的 chmod(2)。

fs.fchmod(fd, mode, callback)

异步版的 fchmod(2)。完成时的回调函数(callback)只接受一个参数:可能出现的异常信息。

fs.fchmodSync(fd, mode)

同步版的 fchmod(2)。

fs.lchmod(path, mode, callback)

异步版的 lchmod(2) 。完成时的回调函数(callback)只接受一个参数:可能出现的异常信息。

仅在 Mac OS X 系统下可用。

fs.lchmodSync(path, mode)

同步版的 lchmod(2)。

fs.stat(path, callback)

异步版的 stat(2)。回调函数（callback） 接收两个参数： (err, stats) ，其中stats 是一个 fs.Stats 对象。 详情请参考  fs.Stats.

fs.lstat(path, callback)

异步版的 lstat(2)。回调函数（callback）接收两个参数：(err, stats) 其中 stats 是一个 fs.Stats 对象。lstat() 与 stat() 相同，区别在于： 若path 是一个符号链接时（symbolic link）,读取的是该符号链接本身，而不是它所 链接到的文件。

fs.fstat(fd, callback)

异步版的 fstat(2)。 回调函数（callback）接收两个参数：(err, stats) 其中stats 是一个 fs.Stats 对象。fstat() 与 stat() 相同，区别在于： 要读取的文件（译者注：即第一个参数）是一个文件描述符（file descriptor） fd 。

fs.statSync(path)

同步版的 stat(2)。返回一个 fs.Stats 实例。

fs.lstatSync(path)

同步版的 lstat(2)。返回一个 fs.Stats 实例。

fs.fstatSync(fd)

同步版的 fstat(2)。返回一个 fs.Stats 实例。

fs.link(srcpath, dstpath, callback)

异步版的 link(2)。 完成时的回调函数（callback）只接受一个参数：可能出现的异常信息。

fs.linkSync(srcpath, dstpath)

同步版的 link(2)。

fs.symlink(srcpath, dstpath[, type], callback)

异步版的 symlink(2)。完成时的回调函数（callback）只接受一个参数：可能出现的异常信息。 type 可以是 'dir' ,  'file' 或者 junction'   (默认是'file' )，此参数仅用于 Windows 系统（其他系统平台会被忽略）。 注意： Windows 系统要求目标路径 必须是一个绝对路径，当使用 'junction' 时，目标路径 参数会自动转换为绝对路径。

fs.symlinkSync(srcpath, dstpath[, type])

同步版的 symlink(2)。

fs.readlink(path, callback)

异步版的 readlink(2)。回调函数（callback）接收两个参数： (err, linkString)

fs.readlinkSync(path)

同步版的 readlink(2).返回符号链接（symbolic link）的字符串值。

fs.realpath(path[, cache], callback)

异步版的 realpath(2)。 回调函数（callback）接收两个参数： (err, resolvedPath) 。可以通过  process.cwd  转化为相对路径。  cache  是一个文字映射路径，可用于强制一个特定的路径以解决或避免额外的  fs.stat  回调以得知真实路径。

示例：

var cache = {'/etc':'/private/etc'};
fs.realpath('/etc/passwd', cache, function (err, resolvedPath) {
  if (err) throw err;
  console.log(resolvedPath);
});

fs.realpathSync(path[, cache])

realpath(2) 的同步版本。返回解析出的路径。

fs.unlink(path, callback)

异步版的 unlink(2)。完成时的回调函数（callback）只接受一个参数：可能出现的异常信息。

fs.unlinkSync(path)

同步版的 unlink(2)。

fs.rmdir(path, callback)

异步版的 rmdir(2)。异步版的 link(2). 完成时的回调函数（callback）只接受一个参数：可能出现的异常信息。

fs.rmdirSync(path)

同步版的 rmdir(2)。

fs.mkdir(path[, mode], callback)

异步版的 mkdir(2)。 异步版的 link(2). 完成时的回调函数（callback）只接受一个参数：可能出现的异常信息。文件mode  默认为0777 。

fs.mkdirSync(path[, mode])

同步版的 mkdir(2)。

fs.readdir(path, callback)

异步版的 readdir(3)。 读取 path 路径所在目录的内容。 回调函数 (callback) 接受两个参数(err, files) 其中files 是一个存储目录中所包含的文件名称的数组，数组中不包括 '.' 和 '..'

fs.readdirSync(path)

同步版的 readdir(3). 返回文件名数组，其中不包括 '.' 和 '..' 目录。

fs.close(fd, callback)

异步版 close(2)。完成时的回调函数(callback)只接受一个参数:可能出现的异常信息。

fs.closeSync(fd)

同步版的 close(2)。

fs.open(path, flags[, mode], callback)

异步版的文件打开. 详见 open(2). flags 可以是:

• 'r' - 以【只读】的方式打开文件. 当文件不存在时产生异常。
• 'r+' - 以【读写】的方式打开文件. 当文件不存在时产生异常。
• 'rs' - 同步模式下，以【只读】的方式打开文件. 指令绕过操作系统的本地文件系统缓存。

该功能主要用于打开 NFS 挂载的文件, 因为它可以让你跳过默认使用的过时本地缓存. 但这实际上非常影响 I/O 操作的性能, 因此除非你确实有这样的需求, 否则请不要使用该标志。

注意: 这并不意味着fs.open()变成了一个同步阻塞的请求. 如果你想要一个同步阻塞的请求你应该使用fs.openSync()

• 'rs+' - 同步模式下, 以【读写】的方式打开文件. 请谨慎使用该方式, 详细请查看 'rs' 的注释。
• 'w' - 以【只写】的形式打开文件. 文件会被创建 (如果文件不存在) 或者覆盖 (如果存在)。
• 'w+' - 以【读写】的方式打开文件. 文件会被创建 (如果文件不存在) 或者覆盖 (如果存在)。
• 'wx+' - 类似 'w+' 区别是如果文件存在则操作会失败。
• 'a' - 以【附加】的形式打开文件，即新写入的数据会附加在原来的文件内容之后. 如果文件不存在则会默认创建。
• 'ax' - 类似 'a' 区别是如果文件存在则操作会失败。
• 'a+' - 以【读取】和【附加】的形式打开文件. 如果文件不存在则会默认创建。
• 'ax+' - 类似 'a+' 区别是如果文件存在则操作会失败。

参数mode 用于设置文件模式 (permission and sticky bits), 不过前提是这个文件是已存在的. 默认情况下是 0666 , 有可读和可写权限。

该 callback 接收两个参数 (err, fd) 。

排除 (exclusive) 标识 'x' （对应 open(2) 的 O_EXCL 标识） 保证  path  是一个新建的文件。 POSIX 操作系统上，即使path  是一个指向不存在位置的符号链接，也会被认定为文件存在。 排除标识在网络文件系统不能确定是否有效。

在 Linux 上，无法对以追加 (append) 模式打开的文件进行指定位置的写入操作。 内核会忽略位置参数并且总是将数据追加到文件尾部。

fs.openSync(path, flags[, mode])

 fs.open()的同步版。

fs.utimes(path, atime, mtime, callback)

fs.utimesSync(path, atime, mtime)

更改 path 所指向的文件的时间戳。

fs.futimes(fd, atime, mtime, callback)

fs.futimesSync(fd, atime, mtime)

更改文件描述符 (file discriptor) 所指向的文件的时间戳。

fs.fsync(fd, callback)

异步版本的 fsync(2)。回调函数仅含有一个异常 (exception) 参数。

fs.fsyncSync(fd)

fsync(2) 的同步版本。

fs.write(fd, buffer, offset, length[, position], callback)

通过文件标识fd ，向指定的文件中写入buffer  。

offset和length可以确定从哪个位置开始写入buffer。

position是参考当前文档光标的位置，然后从该处写入数据。如果typeof position !== 'number'，那么数据会从当前文档位置写入，请看pwrite(2)。

回调中会给出三个参数(err, written, buffer)，written 说明从buffer写入的字节数。

注意，fs.write多次地在同一个文件中使用而没有等待回调是不安全的。在这种情况下，强烈推荐使用fs.createWriteStream。

在 Linux 上，无法对以追加 (append) 模式打开的文件进行指定位置的写入操作。 内核会忽略位置参数并且总是将数据追加到文件尾部。

fs.write(fd, data[, position[, encoding]], callback)

把data 写入到文档中通过指定的fd ,如果data 不是buffer对象的实例则会把值强制转化成一个字符串。

position是参考当前文档光标的位置，然后从该处写入数据。如果typeof position !== 'number'，那么数据会从当前文档位置写入，请看pwrite(2)。

encoding 是预期得到一个字符串编码。

回调会得到这些参数(err, written, string)，written表明传入的string需要写入的字符串长度。注意字节的写入跟字符串写入是不一样的。请看Buffer.byteLength.

与写入buffer不同，必须写入完整的字符串，截取字符串不是符合规定的。这是因为返回的字节的位移跟字符串的位移是不一样的。

注意，fs.write多次地在同一个文件中使用而没有等待回调是不安全的。在这种情况下，强烈推荐使用fs.createWriteStream。

在 Linux 上，无法对以追加 (append) 模式打开的文件进行指定位置的写入操作。 内核会忽略位置参数并且总是将数据追加到文件尾部。

fs.writeSync(fd, buffer, offset, length[, position])

fs.writeSync(fd, data[, position[, encoding]])

同步版本的fs.write() 。返回写入的字节数。

fs.read(fd, buffer, offset, length, position, callback)

从指定的文档标识符fd 读取文件数据。

buffer是缓冲区，数据将会写入这里。

offset 是开始向缓冲区 buffer写入的偏移量。

length 是一个整形值，指定了读取的字节数。

position 是一个整形值，指定了从哪里开始读取文件，如果position为null，将会从文件当前的位置读取数据。

回调函数给定了三个参数，(err, bytesRead, buffer)， 分别为错误，读取的字节和缓冲区。

fs.readSync(fd, buffer, offset, length, position)

fs.read函数的同步版本。 返回bytesRead 的个数。

fs.readFile(filename[, options], callback)

• filename String
• options Object
  • encoding String | Null default = null
  • flag String default = 'r'
• callback Function

异步读取一个文件的全部内容。示例：

fs.readFile('/etc/passwd', function (err, data) {
  if (err) throw err;
  console.log(data);
});

回调函数传递了两个参数 (err, data), data 就是文件的内容。

如果未指定编码方式，原生buffer就会被返回。

fs.readFileSync(filename[, options])

fs.readFile的同步版本。 返回文件名为 filename 的文件内容。

如果 encoding 选项被指定， 那么这个函数返回一个字符串。如果未指定，则返回一个原生buffer。

fs.writeFile(filename, data[, options], callback)

• filename String
• data String | Buffer
• options Object
  • encoding String | Null default = 'utf8'
  • mode Number default = 438 (aka 0666 in Octal)
  • flag String default = 'w'
• callback Function

异步的将数据写入一个文件, 如果文件原先存在，会被替换。 data 可以是一个string，也可以是一个原生buffer。

encoding选项会被忽视如果 data 不是string而是原生buffer。encoding缺省为 'utf8'。

示例：

fs.writeFile('message.txt', 'Hello Node', function (err) {
  if (err) throw err;
  console.log('It\'s saved!');
});

fs.writeFileSync(filename, data[, options])

 fs.writeFile的同步版本。

fs.appendFile(filename, data[, options], callback)

• filename String
• data String | Buffer
• options Object
  • encoding String | Null default = 'utf8'
  • mode Number default = 438 (aka 0666 in Octal)
  • flag String default = 'a'
• callback Function

异步的将数据添加到一个文件的尾部，如果文件不存在，会创建一个新的文件。 data 可以是一个string，也可以是原生buffer。

示例：

fs.appendFile('message.txt', 'data to append', function (err) {
  if (err) throw err;
  console.log('The "data to append" was appended to file!');
});

fs.appendFileSync(filename, data[, options])

fs.appendFile的同步版本。

fs.watchFile(filename[, options], listener)

稳定性: 2 - 不稳定.   尽可能的话推荐使用 fs.watch 来代替。

监视filename 指定的文件的改变. 回调函数 listener 会在文件每一次被访问时被调用。

第二个参数是可选的。 如果提供此参数，options应该是包含两个成员persistent和interval的对象，其中persistent值为boolean类型。persistent指定进程是否应该在文件被监视（watch）时继续运行，interval指定了目标文件被查询的间隔，以毫秒为单位。缺省值为{ persistent: true, interval: 5007 }。

listener有两个参数，第一个为文件现在的状态，第二个为文件的前一个状态。

fs.watchFile('message.text', function (curr, prev) {
  console.log('the current mtime is: ' + curr.mtime);
  console.log('the previous mtime was: ' + prev.mtime);
});

文件状态对象类型为fs.Stat 。

如果你只想在文件被修改时被告知，而不是仅仅在被访问时就告知，你应当在listener回调函数中比较下两个状态对象的mtime属性。即curr.mtime和  prev.mtime.

fs.unwatchFile(filename[, listener])

稳定性: 2 - 不稳定.   尽可能的话推荐使用 fs.watch 来代替。

停止监视文件名为 filename 的文件. 如果 listener 参数被指定, 会移除在fs.watchFile() 函数中指定的那一个listener回调函数。 否则,  所有的  回调函数都会被移除，你将彻底停止监视filename 文件。

调用 fs.unwatchFile()时，传递的文件名为未被监视的文件时，不会发生错误，而会发生一个no-op。

fs.watch(filename[, options][, listener])

稳定性: 2 - 不稳定的

观察指定路径的改变，filename 路径可以是文件或者目录。改函数返回的对象是  fs. FSWatcher 。

第二个参数是可选的. 如果 options选项被提供那么它应当是包含成员persistent和recursive对象， persistent为boolean类型。persistent指定了进程是否“只要文件被监视就继续执行”。recursive表示是否应该关注的所有子目录，或当前目录。这适用于当一个目录是指定的，只有在支持的平台（见下面的说明）

默认值为 { persistent: true, recursive: false }.

监听器的回调函数得到两个参数 (event, filename)。其中event是 'rename'（重命名）或者 'change'（改变），而 filename则是触发事件的文件名。

说明

fs.watch不是完全跨平台的，且在某些情况下不可用。

递归选项是目前支持OS X只有fsevents支持这种文件类型看，这是不可能在任何额外的平台将很快加入。

可用性

此功能依赖于操作系统底层提供的方法来监视文件系统的变化。

• 在 Linux 操作系统上，使用 inotify。
• 在 BSD 操作系统上 ，使用 kqueue。
• 在OS X操作系统上，使用kqueue监视文件用FSEvents监视目录。
• 在 SunOS 操作系统上 (包括 Solaris 和 SmartOS)，使用 event ports。
• 在 Windows 操作系统上，该特性依赖于 ReadDirectoryChangesW。

如果系统底层函数出于某些原因不可用，那么 fs.watch 也就无法工作。例如，监视网络文件系统(如 NFS, SMB 等)的文件或者目录，就时常不能稳定的工作，有时甚至完全不起作用。

你仍然可以调用使用了文件状态调查的 fs.watchFile，但是会比较慢而且比较不可靠。

文件名参数

在回调函数中提供的 filename  参数不是在每一个操作系统中都被支持（当下仅在Linux和Windows上支持）。 即便是在支持的系统中，filename  也不能保证在每一次回调都被提供。因此，不要假设filename  参数总会会在 回调函数中提供，在回调函数中添加检测filename  是否为null的if判断语句。

fs.watch('somedir', function (event, filename) {
  console.log('event is: ' + event);
  if (filename) {
    console.log('filename provided: ' + filename);
  } else {
    console.log('filename not provided');
  }
});

fs.exists(path, callback)

检查指定路径的文件或者目录是否存在。接着通过 callback  传入的参数指明存在 (true) 或者不存在 (false)。示例:

fs.exists('/etc/passwd', function (exists) {
  util.debug(exists ? "it's there" : "no passwd!");
});

fs.exists()是不合时宜的而且它的存在有历史的原因。 从来都不应该有 理由来应用 在您自己的代码 。

特别是，如果检查口是一种反模式，使你容易受到竞争条件在文件存在：另一个进程可以删除 fs.exists()和fs.open() 调用的文件之间。当它不存在打开文件和处理错误。

fs.exists()不推荐使用。

fs.existsSync(path)

fs.exists 函数的同步版。

fs.existsSync()不推荐使用。

fs.access(path[, mode], callback)

测试用户权限指定路径的文件。 模式是一个可选的整数，指定要执行的可访问性检查。 下列常数定义模式的可能值。 它可以创建一个 包含 按位 或两个或多个 值 的掩码。

• fs.F_OK - 文件是显性的调用进程。这是用于确定文件是否存在，但没有说的rwx权限。如果没有指定默认模式。
• fs.R_OK - 文件可以被调用进程读取。
• fs.W_OK - 文件可以被调用进程写入。
• fs.X_OK - 文件可以被调用进程执行。 该状态在windows下无效。最后一个参数是一个回调函数，回调，这是有可能的错误参数调用。如果有任何的可访问性检查失败，错误的观点会密集。下面的示例检查文件/etc/passwd可以读取和写入电流的过程。
  

最后一个参数是一个回调函数，callback，这是有可能的错误参数调用。 如果有任何的可访问性检查失败，错误的观点会密集。 下面的 示例检查 文件 /etc/passwd 可以读取和 写入当前流程 。

fs.access('/etc/passwd', fs.R_OK | fs.W_OK, function(err) {
  util.debug(err ? 'no access!' : 'can read/write');
});

fs.accessSync(path[, mode])

fs.access的同步版本。

Class: fs.Stats

fs.stat() ,  fs.lstat() 和 fs.fstat() 以及他们对应的同步版本返回的对象。

• stats.isFile()
• stats.isDirectory()
• stats.isBlockDevice()
• stats.isCharacterDevice()
• stats.isSymbolicLink() (仅在与 fs.lstat()一起使用时合法)
• stats.isFIFO()
• stats.isSocket()

对于一个普通文件使用 util.inspect(stats)  将会返回一个类似如下输出的字符串：

{ dev: 2114,
  ino: 48064969,
  mode: 33188,
  nlink: 1,
  uid: 85,
  gid: 100,
  rdev: 0,
  size: 527,
  blksize: 4096,
  blocks: 8,
  atime: Mon, 10 Oct 2011 23:24:11 GMT,
  mtime: Mon, 10 Oct 2011 23:24:11 GMT,
  ctime: Mon, 10 Oct 2011 23:24:11 GMT,
  birthtime: Mon, 10 Oct 2011 23:24:11 GMT }

请注意 atime ,  mtime ,  birthtime ,和 ctime 是  Date  对象的实例。而且在比较这些对象的值时你应当使用合适的方法。 大部分情况下，使用  getTime ()  将会返回自  1 January 1970 00:00:00 UTC  以来逝去的毫秒数， 而且这个整形值应该能满足任何比较的使用条件。但是仍然还有一些额外的方法可以用来显示一些模糊的信息。更多细节请查看  MDN JavaScript Reference  页面。

Stat Time Values

在状态对象（stat object）中的时间有以下语义：

• atime "Access Time" - 文件数据上次被访问的时间.
  会被 mknod(2), utimes(2), and read(2) 等系统调用改变。
• mtime "Modified Time" - 文件上次被修改的时间。 会被 mknod(2), utimes(2), and write(2) 等系统调用改变。
• ctime "Change Time" - 文件状态上次改变的时间。 (inode data modification). 会被 chmod(2), chown(2),link(2), mknod(2), rename(2), unlink(2), utimes(2), read(2), and write(2) 等系统调用改变。
• birthtime "Birth Time" - 文件被创建的时间。 会在文件被创建时生成。 在一些不提供文件birthtime的文件系统中, 这个字段会被 ctime 或 1970-01-01T00:00Z (ie, unix epoch timestamp 0)来填充。 在 Darwin 和其他 FreeBSD 系统变体中, 也将 atime 显式地设置成比它现在的 birthtime 更早的一个时间值，这个过程使用了utimes(2)系统调用。

在Node v0.12版本之前, ctime 持有Windows系统的 birthtime 值. 注意在v.0.12版本中,ctime 不再是"creation time", 而且在Unix系统中，他从来都不是。

fs.createReadStream(path[, options])

返回一个新的 ReadStream 对象 (详见 Readable Stream ).

options是一个包含下列缺省值的对象：

{ flags: 'r',
  encoding: null,
  fd: null,
  mode: 0666,
  autoClose: true
}

options可以提供 start 和 end 值用于读取文件内的特定范围而非整个文件。 start 和end 都是包含在范围内的（inclusive, 可理解为闭区间）并且以 0 开始。 encoding 可选为 'utf8', 'ascii', 或者'base64' 。

如果fd指定，ReadStream会忽略路径参数path，将使用指定的文件描述符。这意味着没有公开的事件将被触发。

如果 autoClose为 false 则即使在发生错误时也不会关闭文件描述符 (file descriptor)。 此时你需要负责关闭文件，避免文件描述符泄露 (leak)。 如果 autoClose为 true （缺省值）， 当发生 error或者 end事件时，文件描述符会被自动释放。

一个从100字节的文件中读取最后10字节的例子：

fs.createReadStream('sample.txt', {start: 90, end: 99});

Class: fs.ReadStream

ReadStream是一个可读的流 ( Readable Stream ) .

Event: 'open'

• fd {整形} ReadStream 所使用的文件描述符。

当文件的 ReadStream 被创建时触发。

fs.createWriteStream(path[, options])

返回一个新的 WriteStream 对象 (详见  Writable Stream )。

options是一个包含下列缺省值的对象：

{ flags: 'w',
  encoding: null,
  fd: null,
  mode: 0666 }

options也可以包含一个 start 选项用于指定在文件中开始写入数据的位置。 修改而不替换文件需要 flags 的模式指定为 r+ 而不是默值的 w 。

像上面的ReadStream，如果指定fd，可写流会忽略路径参数，将使用指定的文件描述符。这意味着没有公开的事件将被触发。

Class: fs.WriteStream

WriteStream是一个可写的流 ( Writable Stream ) .

Event: 'open'

• fd {整形} WriteStream 所使用的文件描述符。

当 WriteStream 创建时触发。

file.bytesWritten

已写的字节数。不包含仍在队列中准备写入的数据。

Class: fs.FSWatcher

fs.watch()返回的对象类型。

watcher.close()

停止观察 fs.FSWatcher  对象中的更改。

Event: 'change'

• event{字符串} fs 改变的类型
• filename{字符串} 改变的文件名 (if relevant/available)

当正在观察的目录或文件发生变动时触发。更多细节，详见  fs.watch 。

Event: 'error'

• error{Error 对象}

当产生错误时触发