harmony 鸿蒙@system.file (File Storage)
@system.file (File Storage)
NOTE - The APIs provided by this module are no longer maintained since API Version 10. You are advised to use @ohos.file.fs.
- The initial APIs of this module are supported since API version 3. Newly added APIs will be marked with a superscript to indicate their earliest API version.
Modules to Import
import file from '@system.file';
file.move
move(Object): void
Moves a specified file to a given location.
NOTE
This API is deprecated since API version 10. Use fs.moveFile instead.
System Capability: SystemCapability.FileManagement.File.FileIO.Lite
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
srcUri | string | Yes | Uniform resource identifier (URI) of the file to move. The URI can contain a maximum of 128 characters, excluding the following characters: “*+,:;<=>?[]|\x7F |
dstUri | string | Yes | URI of the location to which the file is to move. The URI can contain a maximum of 128 characters, excluding the following characters: “*+,:;<=>?[]|\x7F |
success | Function | No | Called when the file is moved to the specified location. This API returns the URI of the destination location. |
fail | Function | No | Called when the file fails to be moved. |
complete | Function | No | Called when the execution is complete. |
Error codes
Error Code | Description |
---|---|
202 | Incorrect parameters are detected. |
300 | An I/O error occurs. |
301 | The file or directory does not exist. |
Example
export default {
move() {
file.move({
srcUri: 'internal://app/myfiles1',
dstUri: 'internal://app/myfiles2',
success: function(uri) {
console.log('call success callback success');
},
fail: function(data, code) {
console.error('call fail callback fail, code: ' + code + ', data: ' + data);
},
});
}
}
file.copy
copy(Object): void
Copies a file to the given URI.
NOTE
This API is deprecated since API version 10. Use fs.copyFile instead.
System Capability: SystemCapability.FileManagement.File.FileIO.Lite
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
srcUri | string | Yes | URI of the file to copy. |
dstUri | string | Yes | URI of the location to which the copy is to be saved. The directory of application resources and URI of the tmp type are not supported. |
success | Function | No | Called when the file is copied and saved to the specified location. This API returns the URI of the destination location. |
fail | Function | No | Called when the file fails to be copied. |
complete | Function | No | Called when the execution is complete. |
Error codes
Error Code | Description |
---|---|
202 | Incorrect parameters are detected. |
300 | An I/O error occurs. |
301 | The file or directory does not exist. |
Example
export default {
copy() {
file.copy({
srcUri: 'internal://app/file.txt',
dstUri: 'internal://app/file_copy.txt',
success: function(uri) {
console.log('call success callback success');
},
fail: function(data, code) {
console.error('call fail callback fail, code: ' + code + ', data: ' + data);
},
});
}
}
file.list
list(Object): void
Obtains all files in the specified directory.
NOTE
This API is deprecated since API version 10. Use fs.listFile instead.
System Capability: SystemCapability.FileManagement.File.FileIO.Lite
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
uri | string | Yes | URI of the directory. The URI can contain a maximum of 128 characters, excluding the following characters: “*+,:;<=>?[]|\x7F |
success | Function | No | Called when the file list is obtained. |
fail | Function | No | Called when the file list fails to be obtained. |
complete | Function | No | Called when the execution is complete. |
Return value of success()
Name | Type | Description |
---|---|---|
fileList | Array<FileInfo> | File list. The format of each file is as follows: { uri:‘file1’, lastModifiedTime:1589965924479, length:10240, type: ‘file’ } |
Table 1 FileInfo
Name | Type | Description |
---|---|---|
uri | string | URI of the file. |
lastModifiedTime | number | Timestamp when the file is saved the last time, which is the number of milliseconds elapsed since 1970/01/01 00:00:00 GMT. |
length | number | File size, in bytes. |
type | string | File type. Available values are as follows: - dir: directory - file: file |
Error codes
Error Code | Description |
---|---|
202 | Incorrect parameters are detected. |
300 | An I/O error occurs. |
301 | The file or directory does not exist. |
Example
export default {
list() {
file.list({
uri: 'internal://app/pic',
success: function(data) {
console.log(JSON.stringify(data.fileList));
},
fail: function(data, code) {
console.error('call fail callback fail, code: ' + code + ', data: ' + data);
},
});
}
}
file.get
get(Object): void
Obtains information about a local file.
NOTE
This API is deprecated since API version 10. Use fs.stat instead.
System Capability: SystemCapability.FileManagement.File.FileIO.Lite
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
uri | string | Yes | URI of the file. |
recursive | boolean | No | Whether to recursively obtain the file list under a subdirectory. The default value is false. |
success | Function | No | Called when the file information is obtained. |
fail | Function | No | Called when the file information fails to be obtained. |
complete | Function | No | Called when the execution is complete. |
Return value of success()
Name | Type | Description |
---|---|---|
uri | string | URI of the file. |
length | number | File size, in bytes. |
lastModifiedTime | number | Timestamp when the file is saved the last time, which is the number of milliseconds elapsed since 1970/01/01 00:00:00 GMT. |
type | string | File type. Available values are as follows: - dir: directory - file: file |
subFiles | Array | List of files. |
Error codes
Error Code | Description |
---|---|
202 | Incorrect parameters are detected. |
300 | An I/O error occurs. |
301 | The file or directory does not exist. |
Example
export default {
get() {
file.get({
uri: 'internal://app/file',
success: function(data) {
console.log(data.uri);
},
fail: function(data, code) {
console.error('call fail callback fail, code: ' + code + ', data: ' + data);
},
});
}
}
file.delete
delete(Object): void
Deletes a local file.
NOTE
This API is deprecated since API version 10. Use fs.unlink instead.
System Capability: SystemCapability.FileManagement.File.FileIO.Lite
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
uri | string | Yes | URI of the file to delete. It cannot be an application resource path. |
success | Function | No | Called when the file is deleted. |
fail | Function | No | Called when the file fails to be deleted. |
complete | Function | No | Called when the execution is complete. |
Error codes
Error Code | Description |
---|---|
202 | Incorrect parameters are detected. |
300 | An I/O error occurs. |
301 | The file or directory does not exist. |
Example
export default {
delete() {
file.delete({
uri: 'internal://app/my_file',
success: function() {
console.log('call delete success.');
},
fail: function(data, code) {
console.error('call fail callback fail, code: ' + code + ', data: ' + data);
},
});
}
}
file.writeText
writeText(Object): void
Writes text into a file. Only text files can be read and written.
NOTE
This API is deprecated since API version 10. Use fs.write instead.
System Capability: SystemCapability.FileManagement.File.FileIO.Lite
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
uri | string | Yes | URI of a local file. If it does not exist, a file will be created. |
text | string | Yes | Text to write into the file. |
encoding | string | No | Encoding format. The default format is UTF-8. |
append | boolean | No | Whether to enable the append mode. The default value is false. |
success | Function | No | Called when the text is written into the specified file. |
fail | Function | No | Called when the text fails to be written into the file. |
complete | Function | No | Called when the execution is complete. |
Error codes
Error Code | Description |
---|---|
202 | Incorrect parameters are detected. |
300 | An I/O error occurs. |
Example
export default {
writeText() {
file.writeText({
uri: 'internal://app/test.txt',
text: 'Text that just for test.',
success: function() {
console.log('call writeText success.');
},
fail: function(data, code) {
console.error('call fail callback fail, code: ' + code + ', data: ' + data);
},
});
}
}
file.writeArrayBuffer
writeArrayBuffer(Object): void
Writes buffer data into a file. Only text files can be read and written.
NOTE
This API is deprecated since API version 10. Use fs.write instead.
System Capability: SystemCapability.FileManagement.File.FileIO.Lite
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
uri | string | Yes | URI of a local file. If it does not exist, a file will be created. |
buffer | Uint8Array | Yes | Buffer from which the data is derived. |
position | number | No | Offset to the position where the writing starts. The default value is 0. |
append | boolean | No | Whether to enable the append mode. The default value is false. If the value is true, the position parameter will become invalid. |
success | Function | No | Called when buffer data is written into the file. |
fail | Function | No | Called when buffer data fails to be written into the file. |
complete | Function | No | Called when the execution is complete. |
Error codes
Error Code | Description |
---|---|
202 | Incorrect parameters are detected. |
300 | An I/O error occurs. |
Example
export default {
writeArrayBuffer() {
file.writeArrayBuffer({
uri: 'internal://app/test',
buffer: new Uint8Array(8), // The buffer is of the Uint8Array type.
success: function() {
console.log('call writeArrayBuffer success.');
},
fail: function(data, code) {
console.error('call fail callback fail, code: ' + code + ', data: ' + data);
},
});
}
}
file.readText
readText(Object): void
Reads text from a file. Only text files can be read and written.
NOTE
This API is deprecated since API version 10. Use fs.readText instead.
System Capability: SystemCapability.FileManagement.File.FileIO.Lite
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
uri | string | Yes | URI of a local file. |
encoding | string | No | Encoding format. The default format is UTF-8. |
position | number | No | Position where the reading starts. The default value is the start position of the file. |
length | number | No | Length of the text to read, in bytes. The default value is 4096. |
success | Function | No | Called when the text is read successfully. |
fail | Function | No | Called when the text failed to be read. |
complete | Function | No | Called when the execution is complete. |
Return value of success()
Name | Type | Description |
---|---|---|
text | string | Text read from the specified file. |
Error codes
Error Code | Description |
---|---|
202 | Incorrect parameters are detected. |
300 | An I/O error occurs. |
301 | The file or directory does not exist. |
302 | The text to read exceeds 4 KB. |
Example
export default {
readText() {
file.readText({
uri: 'internal://app/text.txt',
success: function(data) {
console.log('call readText success: ' + data.text);
},
fail: function(data, code) {
console.error('call fail callback fail, code: ' + code + ', data: ' + data);
},
});
}
}
file.readArrayBuffer
readArrayBuffer(Object): void
Reads buffer data from a file. Only text files can be read and written.
NOTE
This API is deprecated since API version 10. Use fs.read instead.
System Capability: SystemCapability.FileManagement.File.FileIO.Lite
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
uri | string | Yes | URI of a local file. |
position | number | No | Position where the reading starts. The default value is the start position of the file. |
length | number | No | Length of data to read. If this parameter is not set, the reading proceeds until the end of the file. |
success | Function | No | Called when the buffer data is read successfully. |
fail | Function | No | Called when the buffer data fails to be read. |
complete | Function | No | Called when the execution is complete. |
Return value of success()
Name | Type | Description |
---|---|---|
buffer | Uint8Array | Data read. |
Error codes
Error Code | Description |
---|---|
202 | Incorrect parameters are detected. |
300 | An I/O error occurs. |
301 | The file or directory does not exist. |
Example
export default {
readArrayBuffer() {
file.readArrayBuffer({
uri: 'internal://app/test',
position: 10,
length: 200,
success: function(data) {
console.log('call readArrayBuffer success: ' + data.buffer);
},
fail: function(data, code) {
console.error('call fail callback fail, code: ' + code + ', data: ' + data);
},
});
}
}
file.access
access(Object): void
Checks whether a file or directory exists.
NOTE
This API is deprecated since API version 10. Use fs.access instead.
System Capability: SystemCapability.FileManagement.File.FileIO.Lite
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
uri | string | Yes | URI of the directory or file to check. |
success | Function | No | Called when the operation is successful. |
fail | Function | No | Called when the operation fails. |
complete | Function | No | Called when the execution is complete. |
Error codes
Error Code | Description |
---|---|
202 | Incorrect parameters are detected. |
300 | An I/O error occurs. |
301 | The file or directory does not exist. |
Example
export default {
access() {
file.access({
uri: 'internal://app/test',
success: function() {
console.log('call access success.');
},
fail: function(data, code) {
console.error('call fail callback fail, code: ' + code + ', data: ' + data);
},
});
}
}
file.mkdir
mkdir(Object): void
Creates a directory.
NOTE
This API is deprecated since API version 10. Use fs.mkdir instead.
System Capability: SystemCapability.FileManagement.File.FileIO.Lite
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
uri | string | Yes | URI of the directory to create. |
recursive | boolean | No | Whether to recursively create upper-level directories of the specified directory. The default value is false. |
success | Function | No | Called when the directory is created. |
fail | Function | No | Called when the directory fails to be created. |
complete | Function | No | Called when the execution is complete. |
Error codes
Error Code | Description |
---|---|
202 | Incorrect parameters are detected. |
300 | An I/O error occurs. |
Example
export default {
mkdir() {
file.mkdir({
uri: 'internal://app/test_directory',
success: function() {
console.log('call mkdir success.');
},
fail: function(data, code) {
console.error('call fail callback fail, code: ' + code + ', data: ' + data);
},
});
}
}
file.rmdir
rmdir(Object): void
Deletes a directory.
NOTE
This API is deprecated since API version 10. Use fs.rmdir instead.
System Capability: SystemCapability.FileManagement.File.FileIO.Lite
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
uri | string | Yes | URI of the directory to delete. |
recursive | boolean | No | Whether to recursively delete files and subdirectories of the specified directory. The default value is false. |
success | Function | No | Called when the directory is deleted. |
fail | Function | No | Called when the directory fails to be deleted. |
complete | Function | No | Called when the execution is complete. |
Error codes
Error Code | Description |
---|---|
202 | Incorrect parameters are detected. |
300 | An I/O error occurs. |
301 | The file or directory does not exist. |
Example
export default {
rmdir() {
file.rmdir({
uri: 'internal://app/test_directory',
success: function() {
console.log('call rmdir success.');
},
fail: function(data, code) {
console.error('call fail callback fail, code: ' + code + ', data: ' + data);
},
});
}
}
你可能感兴趣的鸿蒙文章
harmony 鸿蒙System Common Events (To Be Deprecated Soon)
harmony 鸿蒙System Common Events
harmony 鸿蒙API Reference Document Description
harmony 鸿蒙Enterprise Device Management Overview (for System Applications Only)
harmony 鸿蒙BundleStatusCallback
harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager)
harmony 鸿蒙@ohos.distributedBundle (Distributed Bundle Management)
harmony 鸿蒙@ohos.bundle (Bundle)
harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (EnterpriseAdminExtensionAbility)
- 所属分类: 后端技术
- 本文标签:
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦