Neutralino.filesystem
Neutralino.filesystem
namespace contains methods for handling files.
#
filesystem.createDirectory(path)Creates a new directory. Throws NE_FS_DIRCRER
if directory creation is not possible.
#
Parameterspath
String: New directory path.
#
filesystem.removeDirectory(path)Removes a given directory. Throws NE_FS_RMDIRER
if the removal is not possible.
#
Parameterspath
String: Directory path.
#
filesystem.writeFile(filename, data)Writes a text file. Throws NE_FS_FILWRER
for file write errors.
#
Parametersfilename
String: Filename.data
String: Content of the file.
#
filesystem.appendFile(filename, data)Appends text content to file. Throws NE_FS_FILWRER
for file write errors. If the provided file doesn't exist,
this function creates a new file with data
.
#
Parametersfilename
String: Filename.data
String: Content to append.
#
filesystem.writeBinaryFile(filename, data)Writes a binary file. Throws NE_FS_FILWRER
for file write errors.
#
Parametersfilename
String: Filename.data
ArrayBuffer: Content of the binary file as an ArrayBuffer.
#
filesystem.appendBinaryFile(filename, data)Appends binary data to a file. Throws NE_FS_FILWRER
for file write errors. If the provided file doesn't exist,
this function creates a new file with data
.
#
Parametersfilename
String: Filename.data
ArrayBuffer: Binary content to append as an ArrayBuffer.
#
filesystem.readFile(filename)Reads a text file. Throws NE_FS_FILRDER
for file read errors.
#
Parametersfilename
String: Filename.pos
Number (optional): File cursor position in bytes.size
Number (optional): File reader buffer size in bytes.
#
Return String (awaited):File content.
#
filesystem.readBinaryFile(filename)Reads binary files. Throws NE_FS_FILRDER
for file read errors.
#
Parametersfilename
String: Filename.pos
Number (optional): File cursor position in bytes.size
Number (optional): File reader buffer size in bytes.
#
Return Object (awaited):Content of the binary file as an ArrayBuffer.
#
filesystem.openFile(filename)Creates a readable file stream. Throws NE_FS_FILOPER
for file open errors.
#
Parametersfilename
String: Filename.
#
Return Number (awaited):File stream identifier.
#
filesystem.updateOpenedFile(id, action, data)Invokes file stream actions. Throws NE_FS_UNLTOUP
if the framework can't update the stream. Call this method
to read and seek an opened file (aka a readable stream).
#
Parametersid
Number: File stream identifier.action
String: An action to take. Accepts only the following values:read
: Reads a bytes segment from the file stream.readAll
: Triggers theread
action until file stream cursor position reaches EOF.seek
: Sets the file cursor position.close
: Closes and frees file handler resources.
data
Object (optional): Additional data for theaction
. Send the buffer size in bytes (default: 256 bytes) if theaction
isread
orreadAll
. Send the file stream cursor position if the action isseek
.
#
filesystem.getOpenedFileInfo(id)Returns file stream details. Throws NE_FS_UNLTFOP
if the file stream identifier is not valid.
#
Parametersid
Number: File stream identifier.
#
Return Object (awaited):id
Number: File stream identifier.eof
Boolean: Becomestrue
if the stream reached EOF.pos
Number: File stream cursor position.lastRead
Number: Last read bytes.
#
filesystem.createWatcher(path)Creates a filesystem watcher. Throws NE_FS_UNLCWAT
for watcher creation failures.
#
Parameterspath
String: Directory path.
#
Return Number (awaited):File watcher identifier.
#
filesystem.removeWatcher(watcherId)Removes a filesystem watcher. Throws NE_FS_NOWATID
for watcher removal failures.
#
ParameterswatcherId
Number: File watcher identifier.
#
Return Number (awaited):File watcher identifier.
#
filesystem.removeFile(filename)Removes given file. Throws NE_FS_FILRMER
for file removal errors.
#
Parametersfilename
String: Filename.
#
filesystem.readDirectory(path)Reads directory contents. Throws NE_FS_NOPATHE
if the path doesn't exist.
#
Parameterspath
String: File/directory path.
#
Return Object (awaited):entry
String: file name.type
String: The type of the entry (FILE
orDIRECTORY
).
#
filesystem.copyFile(source, destination)Copies a file to a new destination. Throws NE_FS_COPYFER
if the system cannot copy the file.
#
Parameterssource
String: Source path.destination
String: Destination path.
#
filesystem.moveFile(source, destination)Moves a file to a new destination. Throws NE_FS_MOVEFER
if the system cannot move the file.
#
Parameterssource
String: Source path.destination
String: Destination path.
#
filesystem.getStats(path)Returns file statistics for the given path. If the given path doesn't exist or is inaccessible,NE_FS_NOPATHE
is thrown.
Therefore, you can use this method to check for the existance of a file or directory.
#
Parameterspath
String: File or directory path.
#
Return Object (awaited):size
Number: Size in bytes.isFile
Boolean:true
if the path represents a normal file.isDirectory
Boolean:true
if the path represents a directory.createdAt
Number: On Windows, returns Unix milliseconds of the file creation time — On Unix or Unix-like platforms, returns Unix milliseconds of the last inode modification time.modifiedAt
Number: Unix milliseconds of the last file modification time.