object Fs extends Object with Fs
File System Singleton
- Annotations
- @native() @JSImport( "fs" , JSImport.Namespace )
- Alphabetic
- By Inheritance
- Fs
- Fs
- FSConstants
- Object
- Any
- AnyRef
- Any
- Hide All
- Show All
- Public
- All
Type Members
Value Members
-
final
def
!=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
##(): Int
- Definition Classes
- AnyRef → Any
-
final
def
==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
val
COPYFILE_EXCL: Int
- Definition Classes
- FSConstants
-
val
COPYFILE_FICLONE: Int
- Definition Classes
- FSConstants
-
val
COPYFILE_FICLONE_FORCE: Int
- Definition Classes
- FSConstants
-
val
F_OK: FileMode
File is visible to the calling process.
File is visible to the calling process. This is useful for determining if a file exists, but says nothing about rwx permissions. Default if no mode is specified.
- Definition Classes
- FSConstants
-
val
O_APPEND: Int
Flag indicating that data will be appended to the end of the file.
Flag indicating that data will be appended to the end of the file.
- Definition Classes
- FSConstants
-
val
O_CREAT: Int
Flag indicating to create the file if it does not already exist.
Flag indicating to create the file if it does not already exist.
- Definition Classes
- FSConstants
-
val
O_DIRECT: Int
When set, an attempt will be made to minimize caching effects of file I/O.
When set, an attempt will be made to minimize caching effects of file I/O.
- Definition Classes
- FSConstants
-
val
O_DIRECTORY: Int
Flag indicating that the open should fail if the path is not a directory.
Flag indicating that the open should fail if the path is not a directory.
- Definition Classes
- FSConstants
-
val
O_DSYNC: Int
Flag indicating that the file is opened for synchronized I/O with write operations waiting for data integrity.
Flag indicating that the file is opened for synchronized I/O with write operations waiting for data integrity.
- Definition Classes
- FSConstants
-
val
O_EXCL: Int
Flag indicating that opening a file should fail if the O_CREAT flag is set and the file already exists.
Flag indicating that opening a file should fail if the O_CREAT flag is set and the file already exists.
- Definition Classes
- FSConstants
-
val
O_NOATIME: Int
Flag indicating reading accesses to the file system will no longer result in an update to the atime information associated with the file.
Flag indicating reading accesses to the file system will no longer result in an update to the atime information associated with the file. This flag is available on Linux operating systems only.
- Definition Classes
- FSConstants
-
val
O_NOCTTY: Int
Flag indicating that if path identifies a terminal device, opening the path shall not cause that terminal to become the controlling terminal for the process (if the process does not already have one).
Flag indicating that if path identifies a terminal device, opening the path shall not cause that terminal to become the controlling terminal for the process (if the process does not already have one).
- Definition Classes
- FSConstants
-
val
O_NOFOLLOW: Int
Flag indicating that the open should fail if the path is a symbolic link.
Flag indicating that the open should fail if the path is a symbolic link.
- Definition Classes
- FSConstants
-
val
O_NONBLOCK: Int
Flag indicating to open the file in nonblocking mode when possible.
Flag indicating to open the file in nonblocking mode when possible.
- Definition Classes
- FSConstants
-
val
O_RDONLY: Int
Flag indicating to open a file for read-only access.
Flag indicating to open a file for read-only access.
- Definition Classes
- FSConstants
-
val
O_RDWR: Int
Flag indicating to open a file for read-write access.
Flag indicating to open a file for read-write access.
- Definition Classes
- FSConstants
-
val
O_SYMLINK: Int
Flag indicating to open the symbolic link itself rather than the resource it is pointing to.
Flag indicating to open the symbolic link itself rather than the resource it is pointing to.
- Definition Classes
- FSConstants
-
val
O_SYNC: Int
Flag indicating that the file is opened for synchronous I/O.
Flag indicating that the file is opened for synchronous I/O.
- Definition Classes
- FSConstants
-
val
O_TRUNC: Int
Flag indicating that if the file exists and is a regular file, and the file is opened successfully for write access, its length shall be truncated to zero.
Flag indicating that if the file exists and is a regular file, and the file is opened successfully for write access, its length shall be truncated to zero.
- Definition Classes
- FSConstants
-
val
O_WRONLY: Int
Flag indicating to open a file for write-only access.
Flag indicating to open a file for write-only access.
- Definition Classes
- FSConstants
-
val
R_OK: FileMode
File can be read by the calling process.
File can be read by the calling process.
- Definition Classes
- FSConstants
-
val
S_IFBLK: FileType
File type constant for a block-oriented device file.
File type constant for a block-oriented device file.
- Definition Classes
- FSConstants
-
val
S_IFCHR: FileType
File type constant for a character-oriented device file.
File type constant for a character-oriented device file.
- Definition Classes
- FSConstants
-
val
S_IFDIR: FileType
File type constant for a directory.
File type constant for a directory.
- Definition Classes
- FSConstants
-
val
S_IFIFO: FileType
File type constant for a FIFO/pipe.
File type constant for a FIFO/pipe.
- Definition Classes
- FSConstants
-
val
S_IFLNK: FileType
File type constant for a symbolic link.
File type constant for a symbolic link.
- Definition Classes
- FSConstants
-
val
S_IFMT: FileType
Bit mask used to extract the file type code.
Bit mask used to extract the file type code.
- Definition Classes
- FSConstants
-
val
S_IFREG: FileType
File type constant for a regular file.
File type constant for a regular file.
- Definition Classes
- FSConstants
-
val
S_IFSOCK: FileType
File type constant for a socket.
File type constant for a socket.
- Definition Classes
- FSConstants
-
val
S_IRGRP: FileMode
- Definition Classes
- FSConstants
-
val
S_IROTH: FileMode
- Definition Classes
- FSConstants
-
val
S_IRUSR: FileMode
- Definition Classes
- FSConstants
-
val
S_IRWXG: FileMode
- Definition Classes
- FSConstants
-
val
S_IRWXO: FileMode
- Definition Classes
- FSConstants
-
val
S_IRWXU: FileMode
- Definition Classes
- FSConstants
-
val
S_IWGRP: FileMode
- Definition Classes
- FSConstants
-
val
S_IWOTH: FileMode
- Definition Classes
- FSConstants
-
val
S_IWUSR: FileMode
- Definition Classes
- FSConstants
-
val
S_IXGRP: FileMode
- Definition Classes
- FSConstants
-
val
S_IXOTH: FileMode
- Definition Classes
- FSConstants
-
val
S_IXUSR: FileMode
- Definition Classes
- FSConstants
-
val
W_OK: FileMode
File can be written by the calling process.
File can be written by the calling process.
- Definition Classes
- FSConstants
-
val
X_OK: FileMode
File can be executed by the calling process.
File can be executed by the calling process. This has no effect on Windows (will behave like F_OK).
- Definition Classes
- FSConstants
-
def
access(path: Path, callback: FsCallback0): Unit
Tests a user's permissions for the file specified by path.
Tests a user's permissions for the file specified by path. mode is an optional integer that specifies the accessibility checks to be performed. The following constants define the possible values of mode. It is possible to create a mask consisting of the bitwise OR of two or more values.
- fs.F_OK - File is visible to the calling process. This is useful for determining if a file exists, but says nothing about rwx permissions. Default if no mode is specified.
- FSConstants.R_OK - File can be read by the calling process.
- FSConstants.W_OK - File can be written by the calling process.
- FSConstants.X_OK - File can be executed by the calling process. This has no effect on Windows (will behave like F_OK).
- path
the path (Buffer | String)
- callback
is a callback function that is invoked with a possible error argument. If any of the accessibility checks fail, the error argument will be populated.
- Definition Classes
- Fs
fs.access(path[, mode], callback)
Example: -
def
access(path: Path, mode: FileMode, callback: FsCallback0): Unit
Tests a user's permissions for the file specified by path.
Tests a user's permissions for the file specified by path. mode is an optional integer that specifies the accessibility checks to be performed. The following constants define the possible values of mode. It is possible to create a mask consisting of the bitwise OR of two or more values.
- fs.F_OK - File is visible to the calling process. This is useful for determining if a file exists, but says nothing about rwx permissions. Default if no mode is specified.
- FSConstants.R_OK - File can be read by the calling process.
- FSConstants.W_OK - File can be written by the calling process.
- FSConstants.X_OK - File can be executed by the calling process. This has no effect on Windows (will behave like F_OK).
- path
the path (Buffer | String)
- mode
the optional mode
- callback
is a callback function that is invoked with a possible error argument. If any of the accessibility checks fail, the error argument will be populated.
- Definition Classes
- Fs
fs.access(path[, mode], callback)
Example: -
def
accessSync(path: Path): Unit
- Definition Classes
- Fs
-
def
accessSync(path: Path, mode: FileMode): Unit
Synchronous version of fs.access().
Synchronous version of fs.access(). This throws if any accessibility checks fail, and does nothing otherwise.
- path
the path (Buffer | String)
- mode
the optional mode
- Definition Classes
- Fs
fs.accessSync(path[, mode])
Example: -
def
appendFile(path: FileDescriptor, data: String, callback: FsCallback0): Unit
- Definition Classes
- Fs
-
def
appendFile(path: FileDescriptor, data: Buffer, callback: FsCallback0): Unit
- Definition Classes
- Fs
-
def
appendFile(path: Path, data: String, callback: FsCallback0): Unit
- Definition Classes
- Fs
-
def
appendFile(path: Path, data: Buffer, callback: FsCallback0): Unit
Asynchronously append data to a file, creating the file if it does not yet exist.
Asynchronously append data to a file, creating the file if it does not yet exist. data can be a string or a buffer.
- path
the filename or file descriptor (Buffer | String | Number)
- data
the data to append (Buffer | String)
- callback
the callback function
- Definition Classes
- Fs
fs.appendFile(file, data[, options], callback)
Example: -
def
appendFile(file: FileDescriptor, data: String, options: FileAppendOptions, callback: FsCallback0): Unit
- Definition Classes
- Fs
-
def
appendFile(file: FileDescriptor, data: Buffer, options: FileAppendOptions, callback: FsCallback0): Unit
- Definition Classes
- Fs
-
def
appendFile(file: Path, data: String, options: FileAppendOptions, callback: FsCallback0): Unit
- Definition Classes
- Fs
-
def
appendFile(file: Path, data: Buffer, options: FileAppendOptions, callback: FsCallback0): Unit
Asynchronously append data to a file, creating the file if it does not yet exist.
Asynchronously append data to a file, creating the file if it does not yet exist. data can be a string or a buffer.
- file
the filename or file descriptor (Buffer | String | Number)
- data
the data to append (Buffer | String)
- options
- callback
the callback function
- Definition Classes
- Fs
fs.appendFile(file, data[, options], callback)
Example: -
def
appendFileSync(path: FileDescriptor, data: String): Unit
- Definition Classes
- Fs
-
def
appendFileSync(path: FileDescriptor, data: Buffer): Unit
- Definition Classes
- Fs
-
def
appendFileSync(path: FileDescriptor, data: String, options: FileAppendOptions): Unit
- Definition Classes
- Fs
-
def
appendFileSync(path: FileDescriptor, data: Buffer, options: FileAppendOptions): Unit
- Definition Classes
- Fs
-
def
appendFileSync(path: Path, data: String): Unit
- Definition Classes
- Fs
-
def
appendFileSync(path: Path, data: Buffer): Unit
- Definition Classes
- Fs
-
def
appendFileSync(path: Path, data: String, options: FileAppendOptions): Unit
- Definition Classes
- Fs
-
def
appendFileSync(path: Path, data: Buffer, options: FileAppendOptions): Unit
The synchronous version of fs.appendFile().
The synchronous version of fs.appendFile().
- path
the filename or file descriptor (Buffer | String | Number)
- data
the data to append (Buffer | String)
- options
- returns
undefined.
- Definition Classes
- Fs
-
final
def
asInstanceOf[T0]: T0
- Definition Classes
- Any
-
def
chmod(path: Path, mode: FileMode, callback: FsCallback0): Unit
Asynchronous chmod(2).
Asynchronous chmod(2). No arguments other than a possible exception are given to the completion callback.
- path
the file or directory path (Buffer | String)
- mode
the file or directory mode
- callback
the completion callback.
- Definition Classes
- Fs
-
def
chmodSync(path: Path, mode: FileMode): Unit
Synchronous chmod(2).
Synchronous chmod(2).
- path
the file or directory path (Buffer | String)
- mode
the file or directory mode
- returns
undefined.
- Definition Classes
- Fs
-
def
chown(path: Path, uid: UID, gid: GID, callback: FsCallback0): Unit
Asynchronous chown(2).
Asynchronous chown(2). No arguments other than a possible exception are given to the completion callback.
- path
the file or directory path (Buffer | String)
- uid
the user ID
- gid
the group ID
- callback
the completion callback.
- Definition Classes
- Fs
-
def
chownSync(path: Path, uid: UID, gid: GID): Unit
Synchronous chown(2).
Synchronous chown(2).
- path
the file or directory path (Buffer | String)
- uid
the user ID
- gid
the group ID
- returns
undefined.
- Definition Classes
- Fs
-
def
clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( ... ) @native()
-
def
close(fd: FileDescriptor, callback: FsCallback0): Unit
Asynchronous close(2).
Asynchronous close(2). No arguments other than a possible exception are given to the completion callback.
- Definition Classes
- Fs
fs.close(fd, callback)
Example: -
def
closeSync(fd: FileDescriptor): Unit
Synchronous close(2).
-
def
constants: FSConstants
Returns an object containing commonly used constants for file system operations
-
def
copyFile(src: Path, dest: Path, callback: FsCallback0): Unit
Asynchronously copies src to dest.
Asynchronously copies src to dest. By default, dest is overwritten if it already exists. No arguments other than a possible exception are given to the callback function. Node.js makes no guarantees about the atomicity of the copy operation. If an error occurs after the destination file has been opened for writing, Node.js will attempt to remove the destination.
flags is an optional integer that specifies the behavior of the copy operation. The only supported flag is fs.constants.COPYFILE_EXCL, which causes the copy operation to fail if dest already exists.
- src
the source filename to copy
- dest
the destination filename of the copy operation
- callback
the callback function
- Definition Classes
- Fs
fs.copyFile(src, dest[, flags], callback)
Example: -
def
copyFile(src: Path, dest: Path, flags: Flags, callback: FsCallback0): Unit
Asynchronously copies src to dest.
Asynchronously copies src to dest. By default, dest is overwritten if it already exists. No arguments other than a possible exception are given to the callback function. Node.js makes no guarantees about the atomicity of the copy operation. If an error occurs after the destination file has been opened for writing, Node.js will attempt to remove the destination.
flags is an optional integer that specifies the behavior of the copy operation. The only supported flag is fs.constants.COPYFILE_EXCL, which causes the copy operation to fail if dest already exists.
- src
the source filename to copy
- dest
the destination filename of the copy operation
- flags
the modifiers for copy operation. Default: 0
- callback
the callback function
- Definition Classes
- Fs
fs.copyFile(src, dest[, flags], callback)
Example: -
def
copyFileSync(src: Path, dest: Path, flags: Flags): Unit
Synchronously copies src to dest.
Synchronously copies src to dest. By default, dest is overwritten if it already exists.
Node.js makes no guarantees about the atomicity of the copy operation. If an error occurs after the destination file has been opened for writing, Node.js will attempt to remove the destination.
flags is an optional integer that specifies the behavior of the copy operation. The only supported flag is fs.constants.COPYFILE_EXCL, which causes the copy operation to fail if dest already exists.
- src
the source filename to copy
- dest
the destination filename of the copy operation
- flags
the modifiers for copy operation. Default: 0
- Definition Classes
- Fs
fs.copyFileSync(src, dest[, flags])
Example: -
def
createReadStream(path: Path): ReadStream
- Definition Classes
- Fs
-
def
createReadStream(path: Path, options: FileInputOptions): ReadStream
Returns a new ReadStream object.
Returns a new ReadStream object. (See Readable Stream). Be aware that, unlike the default value set for highWaterMark on a readable stream (16 kb), the stream returned by this method has a default value of 64 kb for the same parameter.
- path
the path (Buffer | String)
- options
the optional stream options
- Definition Classes
- Fs
fs.createReadStream(path[, options])
Example: -
def
createWriteStream(path: Path): WriteStream
- Definition Classes
- Fs
-
def
createWriteStream(path: Path, options: FileOutputOptions): WriteStream
Returns a new WriteStream object.
Returns a new WriteStream object.
- path
the path (Buffer | String)
- options
the optional stream options
- Definition Classes
- Fs
fs.createWriteStream(path[, options])
Example: -
final
def
eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
def
equals(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
def
existsSync(path: Path): Boolean
fs.exists() should not be used to check if a file exists before calling fs.open().
fs.exists() should not be used to check if a file exists before calling fs.open(). Doing so introduces a race condition since other processes may change the file's state between the two calls. Instead, user code should call fs.open() directly and handle the error raised if the file is non-existent.
- Definition Classes
- Fs
fs.existsSync(path)
Example: -
def
fchmod(fd: FileDescriptor, mode: FileMode, callback: FsCallback0): Unit
Asynchronous fchmod(2).
Asynchronous fchmod(2). No arguments other than a possible exception are given to the completion callback.
- Definition Classes
- Fs
fs.fchmod(fd, mode, callback)
Example: -
def
fchmodSync(fd: FileDescriptor, mode: FileMode): Unit
Synchronous fchmod(2).
-
def
fchown(fd: FileDescriptor, uid: UID, gid: GID, callback: FsCallback0): Unit
Asynchronous fchown(2).
Asynchronous fchown(2). No arguments other than a possible exception are given to the completion callback.
- fd
the file descriptor
- uid
the user ID
- gid
the group ID
- callback
the completion callback.
- Definition Classes
- Fs
-
def
fchownSync(fd: FileDescriptor, uid: UID, gid: GID): Unit
Synchronous fchown(2).
-
def
fdatasync(fd: FileDescriptor, callback: FsCallback0): Unit
Asynchronous fdatasync(2).
Asynchronous fdatasync(2). No arguments other than a possible exception are given to the completion callback.
- Definition Classes
- Fs
fs.fdatasync(fd, callback)
Example: -
def
fdatasyncSync(fd: FileDescriptor): Unit
Synchronous fdatasync(2).
-
def
finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( classOf[java.lang.Throwable] )
-
def
fstat(fd: FileDescriptor, options: StatOptions, callback: FsCallback1[StatsVariant]): Unit
- Definition Classes
- Fs
-
def
fstat(fd: FileDescriptor, callback: FsCallback1[Stats]): Unit
Asynchronous fstat(2).
Asynchronous fstat(2). The callback gets two arguments (err, stats) where stats is an fs.Stats object. fstat() is identical to stat(), except that the file to be stat-ed is specified by the file descriptor fd.
- fd
the file descriptor
- callback
the completion callback.
- Definition Classes
- Fs
-
def
fstatSync(fd: FileDescriptor): StatsVariant
- Definition Classes
- Fs
-
def
fstatSync(fd: FileDescriptor, options: StatOptions): StatsVariant
Synchronous fstat(2).
-
def
fsync(fd: FileDescriptor, callback: FsCallback0): Unit
Asynchronous fsync(2).
Asynchronous fsync(2). No arguments other than a possible exception are given to the completion callback.
- fd
the file descriptor
- callback
the completion callback.
- Definition Classes
- Fs
-
def
fsyncSync(fd: FileDescriptor): Unit
Synchronous fsync(2).
-
def
ftruncate(fd: FileDescriptor, length: Int, callback: FsCallback0): Unit
Asynchronous ftruncate(2).
Asynchronous ftruncate(2). No arguments other than a possible exception are given to the completion callback. If the file referred to by the file descriptor was larger than length bytes, only the first length bytes will be retained in the file.
- fd
the file descriptor
- length
the desired length
- callback
the completion callback.
- Definition Classes
- Fs
-
def
ftruncate(fd: FileDescriptor, callback: FsCallback0): Unit
Asynchronous ftruncate(2).
Asynchronous ftruncate(2). No arguments other than a possible exception are given to the completion callback. If the file referred to by the file descriptor was larger than length bytes, only the first length bytes will be retained in the file.
- fd
the file descriptor
- callback
the completion callback.
- Definition Classes
- Fs
-
def
ftruncateSync(fd: FileDescriptor): Unit
- Definition Classes
- Fs
-
def
ftruncateSync(fd: FileDescriptor, length: Int): Unit
Synchronous ftruncate(2).
Synchronous ftruncate(2).
- fd
the file descriptor
- length
the desired length
- returns
undefined.
- Definition Classes
- Fs
-
def
futimes(fd: FileDescriptor, atime: Time, mtime: Time, callback: Function): Unit
Change the file timestamps of a file referenced by the supplied file descriptor.
Change the file timestamps of a file referenced by the supplied file descriptor.
- Definition Classes
- Fs
fs.futimes(fd, atime, mtime, callback)
Example: -
def
futimesSync(fd: FileDescriptor, atime: Time, mtime: Time): Unit
Synchronous version of fs.futimes().
Synchronous version of fs.futimes().
- returns
undefined.
- Definition Classes
- Fs
fs.futimesSync(fd, atime, mtime)
Example: -
final
def
getClass(): Class[_]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
-
def
hasOwnProperty(v: String): Boolean
- Definition Classes
- Object
-
def
hashCode(): Int
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
-
final
def
isInstanceOf[T0]: Boolean
- Definition Classes
- Any
-
def
isPrototypeOf(v: Object): Boolean
- Definition Classes
- Object
-
def
lchmod(path: Path, mode: FileMode, callback: FsCallback0): Unit
Asynchronous lchmod(2).
Asynchronous lchmod(2). No arguments other than a possible exception are given to the completion callback.
- Definition Classes
- Fs
fs.lchmod(path, mode, callback)
Example: -
def
lchmodSync(path: Path, mode: FileMode): Unit
Synchronous lchmod(2).
Synchronous lchmod(2).
- path
the path (Buffer | String)
- mode
the mode (Integer)
- returns
undefined.
- Definition Classes
- Fs
fs.lchmodSync(path, mode)
Example: -
def
lchown(path: Path, uid: UID, gid: GID, callback: FsCallback0): Unit
Asynchronous lchown(2).
Asynchronous lchown(2). No arguments other than a possible exception are given to the completion callback.
- path
the path (Buffer | String)
- uid
the user ID
- gid
the group ID
- callback
the completion callback.
- Definition Classes
- Fs
fs.lchown(path, uid, gid, callback)
Example: -
def
lchownSync(path: Path, uid: UID, gid: GID): Unit
Synchronous chown(2).
Synchronous chown(2).
- path
the path (Buffer | String)
- uid
the user ID
- gid
the group ID
- returns
undefined.
- Definition Classes
- Fs
-
def
link(existingPath: Path, newPath: Path, callback: FsCallback0): Unit
Asynchronous link(2).
Asynchronous link(2). No arguments other than a possible exception are given to the completion callback.
- existingPath
the existing path
- newPath
the new path
- callback
the completion callback.
- Definition Classes
- Fs
fs.link(srcpath, dstpath, callback)
Example: -
def
linkSync(existingPath: Path, newPath: Path): Unit
Synchronous link(2).
Synchronous link(2).
- existingPath
the existing path
- newPath
the new path
- returns
undefined.
- Definition Classes
- Fs
-
def
lstat(path: Path, callback: FsCallback1[Stats]): Unit
Asynchronous lstat(2).
Asynchronous lstat(2). lstat() is identical to stat(), except that if path is a symbolic link, then the link itself is stat-ed, not the file that it refers to.
- path
the path (Buffer | String)
- callback
The callback gets two arguments (err, stats) where stats is a fs.Stats object.
- Definition Classes
- Fs
-
def
lstat(path: Path, options: StatOptions, callback: FsCallback1[StatsVariant]): Unit
- Definition Classes
- Fs
-
def
lstatSync(path: Path, options: StatOptions): StatsVariant
- Definition Classes
- Fs
-
def
lstatSync(path: Path): Stats
Synchronous lstat(2).
-
def
mkdir(path: Path, callback: FsCallback0): Unit
Asynchronous mkdir(2).
Asynchronous mkdir(2). No arguments other than a possible exception are given to the completion callback. mode defaults to 0o777.
- Definition Classes
- Fs
fs.mkdir(path[, mode], callback)
Example: -
def
mkdir(path: Path, mode: MkdirOptions, callback: FsRecursiveCallback0): Unit
- Definition Classes
- Fs
-
def
mkdir(path: Path, mode: MkdirOptions, callback: FsCallback0): Unit
Asynchronous mkdir(2).
Asynchronous mkdir(2). No arguments other than a possible exception are given to the completion callback. mode defaults to 0o777.
After v13.11.0, in recursive mode, the
callback
now receives the first created path as an 2nd argument.
- Definition Classes
- Fs
fs.mkdir(path[, mode], callback)
Example: -
def
mkdir(path: Path, mode: FileMode, callback: FsCallback0): Unit
Asynchronous mkdir(2).
Asynchronous mkdir(2). No arguments other than a possible exception are given to the completion callback. mode defaults to 0o777.
- Definition Classes
- Fs
fs.mkdir(path[, mode], callback)
Example: -
def
mkdirSync(path: Path, mode: MkdirOptions): UndefOr[Path]
- returns
After Node.js v13.11.0, in recursive mode, the first created path is returned now. Otherwise undefined
- Definition Classes
- Fs
-
def
mkdirSync(path: Path): Unit
- Definition Classes
- Fs
-
def
mkdirSync(path: Path, mode: FileMode): Unit
Synchronous mkdir(2).
-
def
mkdtemp(prefix: String, callback: FsCallback1[String]): Unit
Creates a unique temporary directory.
Creates a unique temporary directory. Generates six random characters to be appended behind a required prefix to create a unique temporary directory. The created folder path is passed as a string to the callback's second parameter. The optional options argument can be a string specifying an encoding, or an object with an encoding property specifying the character encoding to use.
- prefix
the prefix
- callback
the callback
- Definition Classes
- Fs
fs.mkdtemp(prefix[, options], callback)
Example: -
def
mkdtemp(prefix: String, options: FileEncodingOptions, callback: FsCallback1[String]): Unit
- Definition Classes
- Fs
-
def
mkdtemp(prefix: String, options: String, callback: FsCallback1[String]): Unit
Creates a unique temporary directory.
Creates a unique temporary directory. Generates six random characters to be appended behind a required prefix to create a unique temporary directory. The created folder path is passed as a string to the callback's second parameter. The optional options argument can be a string specifying an encoding, or an object with an encoding property specifying the character encoding to use.
- prefix
the prefix
- options
the optional encoding setting
- callback
the callback
- Definition Classes
- Fs
fs.mkdtemp(prefix[, options], callback)
Example: -
def
mkdtempSync(prefix: String): String
- Definition Classes
- Fs
-
def
mkdtempSync(prefix: String, options: FileEncodingOptions): String
- Definition Classes
- Fs
-
def
mkdtempSync(prefix: String, options: String): String
The synchronous version of fs.mkdtemp().
The synchronous version of fs.mkdtemp(). Returns the created folder path. The optional options argument can be a string specifying an encoding, or an object with an encoding property specifying the character encoding to use.
- prefix
the prefix
- options
the optional encoding setting
- Definition Classes
- Fs
-
final
def
ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
final
def
notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
-
final
def
notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
-
def
open(path: Path, callback: FsCallback1[FileDescriptor]): Unit
- Definition Classes
- Fs
-
def
open(path: Path, flags: Flags, callback: FsCallback1[FileDescriptor]): Unit
Asynchronous file open.
Asynchronous file open. See open(2).
- path
the path (Buffer | String)
- flags
flags can be:
- 'r' - Open file for reading. An exception occurs if the file does not exist.
- 'r+' - Open file for reading and writing. An exception occurs if the file does not exist.
- 'rs+' - Open file for reading and writing in synchronous mode. Instructs the operating system to bypass the local file system cache. This is primarily useful for opening files on NFS mounts as it allows you to skip the potentially stale local cache. It has a very real impact on I/O performance so don't use this flag unless you need it. Note that this doesn't turn fs.open() into a synchronous blocking call. If that's what you want then you should be using fs.openSync()
- 'w' - Open file for writing. The file is created (if it does not exist) or truncated (if it exists).
- 'wx' - Like 'w' but fails if path exists.
- 'w+' - Open file for reading and writing. The file is created (if it does not exist) or truncated (if it exists).
- 'wx+' - Like 'w+' but fails if path exists.
- 'a' - Open file for appending. The file is created if it does not exist.
- 'ax' - Like 'a' but fails if path exists.
- 'a+' - Open file for reading and appending. The file is created if it does not exist.
- 'ax+' - Like 'a+' but fails if path exists.
- callback
the callback gets two arguments (err, fd)
- Definition Classes
- Fs
fs.open(path, flags[, mode], callback)
Example: -
def
open(path: Path, flags: Flags, mode: FileMode, callback: FsCallback1[FileDescriptor]): Unit
Asynchronous file open.
Asynchronous file open. See open(2).
- path
the path (Buffer | String)
- flags
flags can be:
- 'r' - Open file for reading. An exception occurs if the file does not exist.
- 'r+' - Open file for reading and writing. An exception occurs if the file does not exist.
- 'rs+' - Open file for reading and writing in synchronous mode. Instructs the operating system to bypass the local file system cache. This is primarily useful for opening files on NFS mounts as it allows you to skip the potentially stale local cache. It has a very real impact on I/O performance so don't use this flag unless you need it. Note that this doesn't turn fs.open() into a synchronous blocking call. If that's what you want then you should be using fs.openSync()
- 'w' - Open file for writing. The file is created (if it does not exist) or truncated (if it exists).
- 'wx' - Like 'w' but fails if path exists.
- 'w+' - Open file for reading and writing. The file is created (if it does not exist) or truncated (if it exists).
- 'wx+' - Like 'w+' but fails if path exists.
- 'a' - Open file for appending. The file is created if it does not exist.
- 'ax' - Like 'a' but fails if path exists.
- 'a+' - Open file for reading and appending. The file is created if it does not exist.
- 'ax+' - Like 'a+' but fails if path exists.
- mode
sets the file mode (permission and sticky bits), but only if the file was created. It defaults to 0666, readable and writable.
- callback
the callback gets two arguments (err, fd)
- Definition Classes
- Fs
fs.open(path, flags[, mode], callback)
Example: -
def
openSync(path: Path): FileDescriptor
- Definition Classes
- Fs
-
def
openSync(path: Path, flags: Flags): FileDescriptor
- Definition Classes
- Fs
-
def
openSync(path: Path, flags: Flags, mode: FileMode): FileDescriptor
Synchronous version of fs.open().
Synchronous version of fs.open().
- path
the path (Buffer | String)
- flags
the flags
- mode
the file mode
- returns
an integer representing the file descriptor.
- Definition Classes
- Fs
fs.openSync(path, flags[, mode])
Example: -
def
opendir(path: Path, callback: FsCallback1[Dir]): Unit
- Definition Classes
- Fs
-
def
opendir(path: Path, options: OpendirOptions, callback: FsCallback1[Dir]): Unit
- Definition Classes
- Fs
-
def
opendirSync(path: Path): Dir
- Definition Classes
- Fs
-
def
opendirSync(path: Path, options: OpendirOptions): Dir
- Definition Classes
- Fs
- val promises: FsPromises
-
def
propertyIsEnumerable(v: String): Boolean
- Definition Classes
- Object
-
def
read(fd: FileDescriptor, options: ReadOptions, callback: FsCallback2[Int, Buffer]): Unit
- Definition Classes
- Fs
-
def
read(fd: FileDescriptor, buffer: BufferLike, offset: |[Int, Null], length: |[Int, Null], position: |[Int, Null], callback: FsCallback2[Int, Buffer]): Unit
- Definition Classes
- Fs
-
def
read(fd: FileDescriptor, buffer: Buffer, offset: |[Int, Null], length: |[Int, Null], position: |[Int, Null], callback: FsCallback2[Int, Buffer]): Unit
Read data from the file specified by fd.
Read data from the file specified by fd.
- fd
is the file descriptor
- buffer
is the buffer that the data will be written to.
- offset
is the offset in the buffer to start writing at.
- length
is an integer specifying the number of bytes to read.
- position
is an integer specifying where to begin reading from in the file. If position is null, data will be read from the current file position.
- callback
the callback is given the three arguments, (err, bytesRead, buffer).
- Definition Classes
- Fs
-
def
readFile(file: FileDescriptor, callback: FsCallback1[Buffer]): Unit
- Definition Classes
- Fs
-
def
readFile(file: Path, callback: FsCallback1[Buffer]): Unit
Asynchronously reads the entire contents of a file.
Asynchronously reads the entire contents of a file.
- file
filename or file descriptor
- callback
The callback is passed two arguments (err, data), where data is the contents of the file. If no encoding is specified, then the raw buffer is returned.
- Definition Classes
- Fs
fs.readFile(file[, options], callback)
Example: -
def
readFile(file: FileDescriptor, encoding: String, callback: FsCallback1[String]): Unit
- Definition Classes
- Fs
-
def
readFile(file: Path, encoding: String, callback: FsCallback1[String]): Unit
Asynchronously reads the entire contents of a file.
Asynchronously reads the entire contents of a file.
- file
filename or file descriptor
- encoding
the encoding (default = null)
- callback
The callback is passed two arguments (err, data), where data is the contents of the file. If no encoding is specified, then the raw buffer is returned.
- Definition Classes
- Fs
fs.readFile(file[, options], callback)
Example: -
def
readFile(file: FileDescriptor, options: ReadFileOptions, callback: FsCallback1[Output]): Unit
- Definition Classes
- Fs
-
def
readFile(file: Path, options: ReadFileOptions, callback: FsCallback1[Output]): Unit
Asynchronously reads the entire contents of a file.
Asynchronously reads the entire contents of a file.
- file
filename or file descriptor
- options
the optional settings
- callback
The callback is passed two arguments (err, data), where data is the contents of the file. If no encoding is specified, then the raw buffer is returned.
- Definition Classes
- Fs
fs.readFile(file[, options], callback)
Example: -
def
readFileSync(file: FileDescriptor): Buffer
- Definition Classes
- Fs
-
def
readFileSync(file: Path): Buffer
Synchronous version of fs.readFile.
Synchronous version of fs.readFile.
- file
filename or file descriptor <String> | <Buffer> | <Integer>
- returns
the contents of the file. If the encoding option is specified then this function returns a string. Otherwise it returns a buffer.
- Definition Classes
- Fs
fs.readFileSync(file[, options])
Example: -
def
readFileSync(file: FileDescriptor, options: ReadFileOptions): Output
- Definition Classes
- Fs
-
def
readFileSync(file: Path, options: ReadFileOptions): Output
Synchronous version of fs.readFile.
Synchronous version of fs.readFile. Returns the contents of the file.
- file
filename or file descriptor <String> | <Buffer> | <Integer>
- options
the optional encoding <Object> | <String>
- returns
the contents of the file. If the encoding option is specified then this function returns a string. Otherwise it returns a buffer.
- Definition Classes
- Fs
fs.readFileSync(file[, options])
Example: -
def
readFileSync(file: FileDescriptor, encoding: String): String
- Definition Classes
- Fs
-
def
readFileSync(file: Path, encoding: String): String
Synchronous version of fs.readFile.
Synchronous version of fs.readFile. Returns the contents of the file.
- file
filename or file descriptor <String> | <Buffer> | <Integer>
- encoding
the optional encoding <Object> | <String>
- returns
the contents of the file. If the encoding option is specified then this function returns a string. Otherwise it returns a buffer.
- Definition Classes
- Fs
fs.readFileSync(file[, options])
Example: -
def
readSync(fd: FileDescriptor, buffer: BufferLike, offset: Int, length: Int, position: Int): Int
- Definition Classes
- Fs
-
def
readSync(fd: FileDescriptor, buffer: Buffer, offset: Int, length: Int, position: Int): Int
Synchronous version of fs.read().
Synchronous version of fs.read().
- fd
is the file descriptor
- buffer
is the buffer that the data will be written to.
- offset
is the offset in the buffer to start writing at.
- length
is an integer specifying the number of bytes to read.
- position
is an integer specifying where to begin reading from in the file. If position is null, data will be read from the current file position.
- returns
the number of bytesRead.
- Definition Classes
- Fs
-
def
readdir(path: Path, callback: FsCallback1[Array[String]]): Unit
- Definition Classes
- Fs
-
def
readdir(path: Path, options: ReaddirOptions, callback: FsCallback1[ReaddirArrays2]): Unit
- Definition Classes
- Fs
-
def
readdir(path: Path, options: FileEncodingOptions, callback: FsCallback1[ReaddirArrays]): Unit
- Definition Classes
- Fs
-
def
readdir(path: Path, options: String, callback: FsCallback1[Array[String]]): Unit
Asynchronous readdir(3).
Asynchronous readdir(3). Reads the contents of a directory.
- path
the path (Buffer | String)
- options
the optional options argument can be a string specifying an encoding, or an object with an encoding property specifying the character encoding to use for the filenames passed to the callback. If the encoding is set to 'buffer', the filenames returned will be passed as Buffer objects.
- callback
the callback gets two arguments (err, files) where files is an array of the names of the files in the directory excluding '.' and '..'.
- Definition Classes
- Fs
fs.readdir(path[, options], callback)
Example: -
def
readdirSync(path: Path): Array[String]
- Definition Classes
- Fs
-
def
readdirSync(path: Path, options: ReaddirOptions): Array[String]
- Definition Classes
- Fs
-
def
readdirSync(path: Path, options: String): Array[String]
Synchronous readdir(3).
Synchronous readdir(3).
- path
the path (Buffer | String)
- options
the optional options argument can be a string specifying an encoding, or an object with an encoding property specifying the character encoding to use for the filenames passed to the callback. If the encoding is set to 'buffer', the filenames returned will be passed as Buffer objects.
- returns
an array of filenames excluding '.' and '..'.
- Definition Classes
- Fs
-
def
readlink(path: Path, callback: FsCallback1[String]): Unit
- Definition Classes
- Fs
-
def
readlink(path: Path, options: FileEncodingOptions, callback: FsCallback1[Output]): Unit
- Definition Classes
- Fs
-
def
readlink(path: Path, options: String, callback: FsCallback1[Output]): Unit
Asynchronous readlink(2).
Asynchronous readlink(2). If the encoding is set to 'buffer', the link path returned will be passed as a Buffer object.
- path
the path (Buffer | String)
- options
the optional options argument can be a string specifying an encoding, or an object with an encoding property specifying the character encoding to use for the link path passed to the callback.
- callback
the callback gets two arguments (err, linkString).
- Definition Classes
- Fs
fs.readlink(path[, options], callback)
Example: -
def
readlinkSync(path: Path): String
- Definition Classes
- Fs
-
def
readlinkSync(path: Path, options: FileEncodingOptions): Output
- Definition Classes
- Fs
-
def
readlinkSync(path: Path, options: String): Output
Synchronous readlink(2).
Synchronous readlink(2).
- path
the path (Buffer | String)
- options
the optional options argument can be a string specifying an encoding, or an object with an encoding property specifying the character encoding to use for the link path passed to the callback. If the encoding is set to 'buffer', the link path returned will be passed as a Buffer object.
- returns
the symbolic link's string value.
- Definition Classes
- Fs
-
def
readv(fd: FileDescriptor, buffers: Array[ArrayBufferView], options: ReadOptions, callback: FsCallback2[Int, Array[ArrayBufferView]]): Unit
- Definition Classes
- Fs
-
def
readvSync(fd: FileDescriptor, buffers: Array[ArrayBufferView], options: ReadOptions): Unit
- Definition Classes
- Fs
-
def
realpath(path: Path, callback: FsCallback1[String]): Unit
Asynchronous realpath(2).
Asynchronous realpath(2). The callback gets two arguments (err, resolvedPath). May use process.cwd to resolve relative paths.
The optional options argument can be a string specifying an encoding, or an object with an encoding property specifying the character encoding to use for the path passed to the callback. If the encoding is set to 'buffer', the path returned will be passed as a Buffer object.
- Definition Classes
- Fs
fs.realpath(path[, options], callback)
Example: -
def
realpath(path: Path, options: FileEncodingOptions, callback: FsCallback1[Output]): Unit
- Definition Classes
- Fs
-
def
realpath(path: Path, options: String, callback: FsCallback1[Output]): Unit
Asynchronous realpath(2).
Asynchronous realpath(2). May use process.cwd to resolve relative paths.
- path
the path
- options
The optional options argument can be a string specifying an encoding, or an object with an encoding property specifying the character encoding to use for the path passed to the callback.
- callback
The callback gets two arguments (err, resolvedPath). If the encoding is set to 'buffer', the path returned will be passed as a Buffer object.
- Definition Classes
- Fs
fs.realpath(path[, options], callback)
Example: -
val
realpath: RealpathObject
- Definition Classes
- Fs
-
def
realpathSync(path: Path): String
- Definition Classes
- Fs
-
def
realpathSync(path: Path, options: FileEncodingOptions): Output
Synchronous realpath(3).
Synchronous realpath(3). Only paths that can be converted to UTF8 strings are supported. The optional options argument can be a string specifying an encoding, or an object with an encoding property specifying the character encoding to use for the returned value. If the encoding is set to 'buffer', the path returned will be passed as a Buffer object.
- returns
the resolved path.
- Definition Classes
- Fs
fs.realpathSync(path[, options])
Example: -
def
rename(oldPath: Path, newPath: Path, callback: FsCallback0): Unit
Asynchronous rename(2).
Asynchronous rename(2). No arguments other than a possible exception are given to the completion callback.
- Definition Classes
- Fs
fs.rename(oldPath, newPath, callback)
Example: -
def
renameSync(oldPath: Path, newPath: Path): Unit
Synchronous rename(2).
Synchronous rename(2).
- returns
undefined.
- Definition Classes
- Fs
fs.renameSync(oldPath, newPath)
Example: -
def
rmdir(path: Path, options: RmdirOptions, callback: FsCallback0): Unit
- Definition Classes
- Fs
-
def
rmdir(path: Path, callback: FsCallback0): Unit
Asynchronous rmdir(2).
Asynchronous rmdir(2). No arguments other than a possible exception are given to the completion callback.
- Definition Classes
- Fs
fs.rmdir(path, callback)
Example: -
def
rmdirSync(path: Path, options: RmdirOptions): Unit
- Definition Classes
- Fs
-
def
rmdirSync(path: Path): Unit
Synchronous rmdir(2rmdir).
-
def
stat(path: Path, options: StatOptions, callback: FsCallback1[StatsVariant]): StatsVariant
- Definition Classes
- Fs
-
def
stat(path: Path, callback: FsCallback1[Stats]): Stats
Asynchronous stat(2).
-
def
statSync(path: Path, options: StatOptions): StatsVariant
- Definition Classes
- Fs
-
def
statSync(path: Path): Stats
Synchronous stat(2).
-
def
symlink(target: Path, path: Path, callback: FsCallback0): Unit
Asynchronous symlink(2).
Asynchronous symlink(2). No arguments other than a possible exception are given to the completion callback. The type argument can be set to 'dir', 'file', or 'junction' (default is 'file') and is only available on Windows (ignored on other platforms). Note that Windows junction points require the destination path to be absolute. When using 'junction', the target argument will automatically be normalized to absolute path.
- Definition Classes
- Fs
fs.symlink(target, path[, type], callback)
Example: -
def
symlink(target: Path, path: Path, type: String, callback: FsCallback0): Unit
Asynchronous symlink(2).
Asynchronous symlink(2). No arguments other than a possible exception are given to the completion callback. The type argument can be set to 'dir', 'file', or 'junction' (default is 'file') and is only available on Windows (ignored on other platforms). Note that Windows junction points require the destination path to be absolute. When using 'junction', the target argument will automatically be normalized to absolute path.
- Definition Classes
- Fs
fs.symlink(target, path[, type], callback)
Example: -
def
symlinkSync(target: Path, path: Path): Unit
- Definition Classes
- Fs
-
def
symlinkSync(target: Path, path: Path, type: String): Unit
Synchronous symlink(2).
Synchronous symlink(2).
- returns
undefined.
- Definition Classes
- Fs
fs.symlinkSync(target, path[, type])
Example: -
final
def
synchronized[T0](arg0: ⇒ T0): T0
- Definition Classes
- AnyRef
-
def
toLocaleString(): String
- Definition Classes
- Object
-
def
toString(): String
- Definition Classes
- AnyRef → Any
-
def
truncate(path: Path, callback: FsCallback0): Unit
- Definition Classes
- Fs
-
def
truncate(path: Path, length: Int, callback: FsCallback0): Unit
Asynchronous truncate(2).
Asynchronous truncate(2). No arguments other than a possible exception are given to the completion callback. A file descriptor can also be passed as the first argument. In this case, fs.ftruncate() is called.
- path
the path <String> | <Buffer>
- length
the length
- callback
the completion callback.
- Definition Classes
- Fs
fs.truncate(path, length, callback)
Example: -
def
truncateSync(path: Path): Unit
- Definition Classes
- Fs
-
def
truncateSync(path: Path, length: Int): Unit
Synchronous truncate(2).
Synchronous truncate(2). In this case, fs.ftruncateSync() is called.
- path
the path or file descriptor - <String> | <Buffer> | <Integer>
- length
the length
- returns
undefined.
- Definition Classes
- Fs
fs.truncateSync(path, length)
Example: -
def
unlink(path: Path, callback: FsCallback0): Unit
Asynchronous unlink(2).
Asynchronous unlink(2). No arguments other than a possible exception are given to the completion callback.
- Definition Classes
- Fs
fs.unlink(path, callback)
Example: -
def
unlinkSync(path: Path): Unit
Synchronous unlink(2).
-
def
unwatchFile(path: Path): Unit
- Definition Classes
- Fs
-
def
unwatchFile(path: Path, listener: FsCallback0): Unit
Stop watching for changes on filename.
Stop watching for changes on filename. If listener is specified, only that particular listener is removed. Otherwise, all listeners are removed and you have effectively stopped watching filename.
Calling fs.unwatchFile() with a filename that is not being watched is a no-op, not an error.
Note: fs.watch() is more efficient than fs.watchFile() and fs.unwatchFile(). fs.watch() should be used instead of fs.watchFile() and fs.unwatchFile() when possible.
- Definition Classes
- Fs
fs.unwatchFile(filename[, listener])
Example: -
def
utimes(path: Path, atime: Time, mtime: Time, callback: FsCallback0): Unit
Change file timestamps of the file referenced by the supplied path.
Change file timestamps of the file referenced by the supplied path.
Note: the arguments atime and mtime of the following related functions does follow the below rules:
If the value is a numberable string like '123456789', the value would get converted to corresponding number. If the value is NaN or Infinity, the value would get converted to Date.now().
- Definition Classes
- Fs
fs.utimes(path, atime, mtime, callback)
Example: -
def
utimesSync(path: Path, atime: Time, mtime: Time): Unit
Synchronous version of fs.utimes().
Synchronous version of fs.utimes().
- returns
undefined.
- Definition Classes
- Fs
fs.utimesSync(path, atime, mtime)
Example: -
def
valueOf(): Any
- Definition Classes
- Object
-
final
def
wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... ) @native()
-
def
watch(filename: Path): FSWatcher
- Definition Classes
- Fs
-
def
watch(filename: Path, options: FSWatcherOptions): FSWatcher
Watch for changes on filename, where filename is either a file or a directory.
Watch for changes on filename, where filename is either a file or a directory. The returned object is a fs.FSWatcher.
The second argument is optional. If options is provided as a string, it specifies the encoding. Otherwise options should be passed as an object.
The listener callback gets two arguments (event, filename). event is either 'rename' or 'change', and filename is the name of the file which triggered the event.
- filename
the filename (Buffer | String)
- options
- returns
- Definition Classes
- Fs
fs.watch(filename[, options][, listener])
Example: -
def
watch(filename: Path, listener: Function2[EventType, String, Any]): FSWatcher
Watch for changes on filename, where filename is either a file or a directory.
Watch for changes on filename, where filename is either a file or a directory. The returned object is a fs.FSWatcher.
The second argument is optional. If options is provided as a string, it specifies the encoding. Otherwise options should be passed as an object.
The listener callback gets two arguments (event, filename). event is either 'rename' or 'change', and filename is the name of the file which triggered the event.
- filename
the filename (Buffer | String)
- listener
the listener callback gets two arguments (eventType, filename). eventType is either 'rename' or 'change', and filename is the name of the file which triggered the event.
- returns
- Definition Classes
- Fs
fs.watch(filename[, options][, listener])
Example: -
def
watch(filename: Path, options: FSWatcherOptions, listener: Function2[EventType, String, Any]): FSWatcher
Watch for changes on filename, where filename is either a file or a directory.
Watch for changes on filename, where filename is either a file or a directory. The returned object is a fs.FSWatcher.
The second argument is optional. If options is provided as a string, it specifies the encoding. Otherwise options should be passed as an object.
The listener callback gets two arguments (event, filename). event is either 'rename' or 'change', and filename is the name of the file which triggered the event.
- filename
the filename (Buffer | String)
- options
- listener
the callback function
- returns
- Definition Classes
- Fs
fs.watch(filename[, options][, listener])
Example: -
def
watchFile(filename: Path, listener: Function2[Stats, Stats, Any]): FSStatWatcher
Watch for changes on filename.
Watch for changes on filename. The callback listener will be called each time the file is accessed.
The options argument may be omitted. If provided, it should be an object. The options object may contain a boolean named persistent that indicates whether the process should continue to run as long as files are being watched. The options object may specify an interval property indicating how often the target should be polled in milliseconds. The default is { persistent: true, interval: 5007 }.
- filename
the filename (Buffer | String)
- listener
the callback
- Definition Classes
- Fs
-
def
watchFile(filename: Path, options: FileWatcherOptions, listener: Function2[Stats, Stats, Any]): FSStatWatcher
Watch for changes on filename.
Watch for changes on filename. The callback listener will be called each time the file is accessed.
The options argument may be omitted. If provided, it should be an object. The options object may contain a boolean named persistent that indicates whether the process should continue to run as long as files are being watched. The options object may specify an interval property indicating how often the target should be polled in milliseconds. The default is { persistent: true, interval: 5007 }.
- filename
the filename (Buffer | String)
- options
- listener
the callback
- Definition Classes
- Fs
-
def
write(fd: FileDescriptor, string: String, callback: FsCallback2[Int, String]): Unit
- Definition Classes
- Fs
-
def
write(fd: FileDescriptor, string: String, position: Int, callback: FsCallback2[Int, String]): Unit
- Definition Classes
- Fs
-
def
write(fd: FileDescriptor, string: String, position: Int, encoding: String, callback: FsCallback2[Int, String]): Unit
Write string to the file specified by fd.
Write string to the file specified by fd. If string is not a string, then the value will be coerced to one. Unlike when writing buffer, the entire string must be written. No substring may be specified. This is because the byte offset of the resulting data may not be the same as the string offset. Note that it is unsafe to use fs.write multiple times on the same file without waiting for the callback. For this scenario, fs.createWriteStream is strongly recommended. On Linux, positional writes don't work when the file is opened in append mode. The kernel ignores the position argument and always appends the data to the end of the file.
- fd
the file descriptor
- string
the data to write
- position
refers to the offset from the beginning of the file where this data should be written. If typeof position !== 'number' the data will be written at the current position. See pwrite(2).
- encoding
is the expected string encoding.
- callback
will receive the arguments (err, written, string) where written specifies how many bytes the passed string required to be written. Note that bytes written is not the same as string characters. See Buffer.byteLength.
- Definition Classes
- Fs
fs.write(fd, string[, position[, encoding]], callback)
Example: -
def
write(fd: FileDescriptor, buffer: BufferLike, offset: |[Int, Null], length: |[Int, Null], position: |[Int, Null], callback: FsCallback2[Int, Buffer]): Unit
- Definition Classes
- Fs
-
def
write(fd: FileDescriptor, buffer: Uint8Array, offset: |[Int, Null], length: |[Int, Null], position: |[Int, Null], callback: FsCallback2[Int, Buffer]): Unit
Write buffer to the file specified by fd.
Write buffer to the file specified by fd.
Note: that it is unsafe to use fs.write multiple times on the same file without waiting for the callback. For this scenario, fs.createWriteStream is strongly recommended.
On Linux, positional writes don't work when the file is opened in append mode. The kernel ignores the position argument and always appends the data to the end of the file.
- fd
the file descriptor
- buffer
the buffer containing the data to write
- offset
determines the part of the buffer to be written, and length is an integer specifying the number of bytes to write.
- length
the optional length of the data to write
- position
refers to the offset from the beginning of the file where this data should be written. If typeof position !== 'number', the data will be written at the current position. See pwrite(2).
- callback
will be given three arguments (err, written, buffer) where written specifies how many bytes were written from buffer.
- Definition Classes
- Fs
fs.write(fd, buffer[, offset[, length[, position]]], callback)
Example: -
def
writeFile(file: String, data: BufferLike, callback: FsCallback0): Unit
- Definition Classes
- Fs
-
def
writeFile(file: String, data: BufferLike, options: FileWriteOptions, callback: FsCallback0): Unit
- Definition Classes
- Fs
-
def
writeFile(file: String, data: String, callback: FsCallback0): Unit
- Definition Classes
- Fs
-
def
writeFile(file: String, data: String, options: FileWriteOptions, callback: FsCallback0): Unit
- Definition Classes
- Fs
-
def
writeFile(file: String, data: Uint8Array, callback: FsCallback0): Unit
- Definition Classes
- Fs
-
def
writeFile(file: String, data: Uint8Array, options: FileWriteOptions, callback: FsCallback0): Unit
Asynchronously writes data to a file, replacing the file if it already exists.
Asynchronously writes data to a file, replacing the file if it already exists. data can be a string or a buffer. The encoding option is ignored if data is a buffer. It defaults to 'utf8'
- Definition Classes
- Fs
fs.writeFile(file, data[, options], callback)
Example: -
def
writeFileSync(file: FileDescriptor, data: BufferLike): Unit
- Definition Classes
- Fs
-
def
writeFileSync(file: FileDescriptor, data: BufferLike, options: FileWriteOptions): Unit
- Definition Classes
- Fs
-
def
writeFileSync(file: FileDescriptor, data: String): Unit
- Definition Classes
- Fs
-
def
writeFileSync(file: FileDescriptor, data: String, options: FileWriteOptions): Unit
- Definition Classes
- Fs
-
def
writeFileSync(file: FileDescriptor, data: Uint8Array): Unit
- Definition Classes
- Fs
-
def
writeFileSync(file: FileDescriptor, data: Uint8Array, options: FileWriteOptions): Unit
- Definition Classes
- Fs
-
def
writeFileSync(file: Path, data: BufferLike): Unit
- Definition Classes
- Fs
-
def
writeFileSync(file: Path, data: BufferLike, options: FileWriteOptions): Unit
- Definition Classes
- Fs
-
def
writeFileSync(file: Path, data: String): Unit
- Definition Classes
- Fs
-
def
writeFileSync(file: Path, data: String, options: FileWriteOptions): Unit
- Definition Classes
- Fs
-
def
writeFileSync(file: Path, data: Uint8Array): Unit
- Definition Classes
- Fs
-
def
writeFileSync(file: Path, data: Uint8Array, options: FileWriteOptions): Unit
The synchronous version of fs.writeFile().
The synchronous version of fs.writeFile().
- returns
undefined.
- Definition Classes
- Fs
fs.writeFileSync(file, data[, options])
Example: -
def
writeSync(fd: FileDescriptor, data: String): Unit
- Definition Classes
- Fs
-
def
writeSync(fd: FileDescriptor, data: String, encoding: String): Unit
- Definition Classes
- Fs
-
def
writeSync(fd: FileDescriptor, data: String, position: Int): Unit
- Definition Classes
- Fs
-
def
writeSync(fd: FileDescriptor, data: String, position: Int, encoding: String): Unit
Write string to the file specified by fd.
Write string to the file specified by fd.
- fd
the given file descriptor
- data
the given string
- position
refers to the offset from the beginning of the file where this data should be written.
- encoding
is the expected string encoding.
- Definition Classes
- Fs
fs.writeSync(fd, string[, position[, encoding]])
Example: -
def
writeSync(fd: FileDescriptor, buffer: BufferLike): Unit
- Definition Classes
- Fs
-
def
writeSync(fd: FileDescriptor, buffer: BufferLike, offset: Int): Unit
- Definition Classes
- Fs
-
def
writeSync(fd: FileDescriptor, buffer: BufferLike, offset: Int, length: Int): Unit
- Definition Classes
- Fs
-
def
writeSync(fd: FileDescriptor, buffer: BufferLike, offset: Int, length: Int, position: Int): Unit
- Definition Classes
- Fs
-
def
writeSync(fd: FileDescriptor, buffer: Uint8Array): Unit
- Definition Classes
- Fs
-
def
writeSync(fd: FileDescriptor, buffer: Uint8Array, offset: Int): Unit
- Definition Classes
- Fs
-
def
writeSync(fd: FileDescriptor, buffer: Uint8Array, offset: Int, length: Int): Unit
- Definition Classes
- Fs
-
def
writeSync(fd: FileDescriptor, buffer: Uint8Array, offset: Int, length: Int, position: Int): Unit
Write buffer to the file specified by fd.
Write buffer to the file specified by fd.
- fd
the given file descriptor
- buffer
the given buffer
- offset
determines the part of the buffer to be written, and length is an integer specifying the number of bytes to write.
- length
the optional length of the data to write
- position
refers to the offset from the beginning of the file where this data should be written.
- Definition Classes
- Fs
fs.writeSync(fd, buffer[, offset[, length[, position]]])
Example: -
def
writev(fd: FileDescriptor, buffers: Array[ArrayBufferView], position: Int, fsCallback2: FsCallback2[Int, Array[ArrayBufferView]]): Unit
- Definition Classes
- Fs
-
def
writevSync(fd: FileDescriptor, buffers: Array[ArrayBufferView]): Unit
- Definition Classes
- Fs
-
def
writevSync(fd: FileDescriptor, buffers: Array[ArrayBufferView], position: Int): Unit
- Definition Classes
- Fs