快應用 文件存儲

接口聲明

{"name": "system.file"}

導入模塊

import file from '@system.file' 
或 
const file = require('@system.file')

接口定義

file.move(OBJECT)

將源文件移動到指定位置，接口中使用的URI描述請參考 文件組織

參數(shù)：

fail返回錯誤代碼：

示例：

file.move({
  srcUri: 'internal://cache/path/to/file',
  dstUri: 'internal://files/path/to/file',
  success: function (uri) {
    console.log(`move success: ${uri}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

file.copy(OBJECT)

將源文件復制一份并存儲到指定位置，接口中使用的URI描述請參考 文件組織

參數(shù)：

fail返回錯誤代碼：

示例：

file.copy({
  srcUri: 'internal://cache/path/to/file',
  dstUri: 'internal://files/path/to/file',
  success: function (uri) {
    console.log(`copy success: ${uri}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

file.list(OBJECT)

獲取指定目錄下的文件列表，接口中使用的URI描述請參考 文件組織

參數(shù)：

success返回值：

每個文件的元信息：

fail返回錯誤代碼：

示例：

file.list({
  uri: 'internal://files/movies/',
  success: function (data) {
    console.log(data.fileList)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

file.get(OBJECT)

獲取本地文件的文件信息，接口中使用的 URI 描述請參考 文件組織

參數(shù)：

success返回值：

fail返回錯誤代碼：

示例：

file.get({
  uri: 'internal://files/path/to/file',
  success: function (data) {
    console.log(data.uri);
    console.log(data.length);
    console.log(data.lastModifiedTime);
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

file.delete(OBJECT)

刪除本地存儲的文件，接口中使用的 URI 描述請參考 文件組織

參數(shù)：

fail返回錯誤代碼：

示例：

file.delete({
  uri: 'internal://files/path/to/file',
  success: function (data) {
    console.log('handling success')
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

file.writeText(OBJECT)1010+

寫文本到文件

參數(shù)：

fail返回錯誤代碼：

示例：

file.writeText({
  uri: 'internal://files/work/demo.txt',
  text: 'test',
  success: function () {
    console.log('handling success')
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

file.writeArrayBuffer(OBJECT)1010+

寫B(tài)uffer到文件

參數(shù)：

fail返回錯誤代碼：

示例：

file.writeArrayBuffer({
  uri: 'internal://files/work/demo',
  buffer: buffer,
  success: function () {
    console.log('handling success')
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

file.readText(OBJECT)1010+

從文件中讀取文本

參數(shù)：

success返回值：

fail返回錯誤代碼：

示例：

file.readText({
  uri: 'internal://files/work/demo.txt',
  success: function (data) {
    console.log('text: '+ data.text)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

file.readArrayBuffer(OBJECT)1010+

從文件中讀取Buffer

參數(shù)：

success返回值：

fail返回錯誤代碼：

示例：

file.readArrayBuffer({
  uri: 'internal://files/work/demo',
  position: 100,
  length: 100,
  success: function (data) {
    console.log('buffer.length: '+ data.buffer.length)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

file.access(OBJECT)1060+

判斷文件或目錄是否存在

參數(shù)：

fail 返回錯誤代碼：

示例：

file.access({
  uri: 'internal://files/test',
  success: function(data) {
    console.log(`handling success`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

file.mkdir(OBJECT)1060+

創(chuàng)建目錄

參數(shù)：

fail 返回錯誤代碼：

示例：

file.mkdir({
  uri: 'internal://files/dir/',
  success: function(data) {
    console.log(`handling success`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

file.rmdir(OBJECT)1060+

刪除目錄

參數(shù)：

fail 返回錯誤代碼：

示例：

file.rmdir({
  uri: 'internal://files/dir/',
  success: function(data) {
    console.log(`handling success`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

后臺運行限制

無限制。

后臺運行詳細用法參見 后臺運行腳本。