宜信同城网交流论坛技术专版技术专区IO模块管理本地文件系统，用于对文件系统的目录浏览、文件的读取、文件的写入等操作。 ...为了安全管理应用的资源目录，规范对文件系统的操作，5+ API在系统应用目录的基础设计了应用沙 ...

admin 发表于 2023-2-16 18:54:52

IO模块管理本地文件系统，用于对文件系统的目录浏览、文件的读取、文件的写入等操作。 ...

<div id="article_content" class="article_content clearfix">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/kdoc_html_views-1a98987dfd.css">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/ck_htmledit_views-6e43165c0a.css">
 <div id="content_views" class="htmledit_views">
 为了安全管理应用的资源目录，规范对文件系统的操作，5+ API在系统应用目录的基础设计了应用沙盒目录， 分为私有目录和公共目录两种类型，私有目录仅应用自身可以访问，公共目录在多应用环境时（如小程序SDK）所有应用都可访问。
<ul><li>应用私有资源目录，对应常量<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.PRIVATE_WWW">plus.io.PRIVATE_WWW</a>，仅应用自身可读</li><li>应用私有文档目录，对应常量<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.PRIVATE_DOC">plus.io.PRIVATE_DOC</a>，仅应用自身可读写</li><li>应用公共文档目录，对应常量<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.PUBLIC_DOCUMENTS">plus.io.PUBLIC_DOCUMENTS</a>，多应用时都可读写，常用于保存应用间共享文件</li><li>应用公共下载目录，对应常量<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.PUBLIC_DOWNLOADS">plus.io.PUBLIC_DOWNLOADS</a>，多应用时都可读写，常用于保存下载文件</li></ul>
 调用5+ API时通常需要传入文件路径，为了方便理解，分为以下类型：
<ul><li>相对路径URL，对应类型<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.RelativeURL">plus.io.RelativeURL</a>，以“_”开头，用于访问5+ API定义的应用沙盒目录</li><li>本地绝对路径URL，对应类型<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.LocalURL">plus.io.LocalURL</a>，以“file://”开头，后面跟随系统的绝对路径，用于访问应用沙盒外的目录，如系统相册等</li><li>网络路径URL，对应类型<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.RemoteURL">plus.io.RemoteURL</a>，以“http://”或“https://”开头，用于访问网络资源</li></ul>


<h2 style="margin-left:.8em;">常量：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.PRIVATE_WWW">PRIVATE_WWW</a>: 应用私有资源目录常量</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.PRIVATE_DOC">PRIVATE_DOC</a>: 应用私有文档目录常量</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.PUBLIC_DOCUMENTS">PUBLIC_DOCUMENTS</a>: 应用公共文档目录常量</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.PUBLIC_DOWNLOADS">PUBLIC_DOWNLOADS</a>: 应用公共下载目录常量</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.requestFileSystem">requestFileSystem</a>: 请求本地文件系统对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.resolveLocalFileSystemURL">resolveLocalFileSystemURL</a>: 通过URL参数获取目录对象或文件对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.convertLocalFileSystemURL">convertLocalFileSystemURL</a>: 将本地URL路径转换成平台绝对路径</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.convertAbsoluteFileSystem">convertAbsoluteFileSystem</a>: 将平台绝对路径转换成本地URL路径</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.getAudioInfo">getAudioInfo</a>: 获取音频文件信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.getFileInfo">getFileInfo</a>: 获取文件信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.getImageInfo">getImageInfo</a>: 获取图片信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.getVideoInfo">getVideoInfo</a>: 获取视频文件信息</li></ul>
<h2 style="margin-left:.8em;">对象：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry">DirectoryEntry</a>: 文件系统中的目录对象，用于管理特定的本地目录</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.DirectoryReader">DirectoryReader</a>: 读取目录信息对象，用于获取目录中包含的文件及子目录</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.File">File</a>: 文件系统中的文件数据对象，用于获取文件的数据</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry">FileEntry</a>: 文件系统中的文件对象，用于管理特定的本地文件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader">FileReader</a>: 文件系统中的读取文件对象，用于获取文件的内容</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter">FileWriter</a>: 文件系统中的写文件对象，用于写入文件内容</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileSystem">FileSystem</a>: 文件系统对象，用于管理特定本地文件目录</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.Flags">Flags</a>: JSON对象，获取文件操作的参数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.Metadata">Metadata</a>: JSON对象，保存文件或目录的状态信息对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEvent">FileEvent</a>: 文件或目录操作事件对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.RelativeURL">RelativeURL</a>: 相对路径URL</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.LocalURL">LocalURL</a>: 本地绝对路径URL</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.RemoteURL">RemoteURL</a>: 网络路径URL</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.AudioInfo">AudioInfo</a>: JSON对象，音频文件信息对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileInfo">FileInfo</a>: JSON对象，文件信息对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.ImageInfo">ImageInfo</a>: JSON对象，图片信息对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.VideoInfo">VideoInfo</a>: JSON对象，视频文件信息对象</li></ul>
<h2 style="margin-left:.8em;">回调方法：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileEventCallback">FileEventCallback</a>: 文件事件回调</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileSystemSuccessCallback">FileSystemSuccessCallback</a>: 请求文件系统成功的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileResolveSuccessCallback">FileResolveSuccessCallback</a>: 通过URL参数获取目录或文件对象成功的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.MetadataSuccessCallback">MetadataSuccessCallback</a>: 获取文件或目录状态信息成功的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.EntrySuccessCallback">EntrySuccessCallback</a>: 操作文件或目录对象成功的回调函数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.EntrysSuccessCallback">EntrysSuccessCallback</a>: 操作文件或目录对象数组成功的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileWriterSuccessCallback">FileWriterSuccessCallback</a>: 写文件操作成功的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileSuccessCallback">FileSuccessCallback</a>: 文件操作成功的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a>: 文件操作失败的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.IOSuccessCallback">IOSuccessCallback</a>: 成功回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.IOFailCallback">IOFailCallback</a>: 失败回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.IOCompleteCallback">IOCompleteCallback</a>: 操作完成回调函数</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
5+功能模块（permissions）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"File": {
"description": "文件系统"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">PRIVATE_WWW</h1>
应用私有资源目录常量
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.io.PRIVATE_WWW;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
本地文件系统常量，Number类型，固定值1，对应<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.RelativeURL">相对路径URL</a>为"_www"开头的地址。应用所有资源保存到此目录，仅本应用可访问。为了确保应用资源的安全性，通常此目录只可读。 注意： 需要将应用设置为释放资源模式才能访问此目录，配置方法：
<ul><li>uni-app项目，在manifest.json的"app-plus"节点下添加"runmode":"liberate"</li><li>5+ App项目，在manifest.json的"plus"节点下添加"runmode":"liberate"</li></ul>
提交云端打包生效，详见<ahref="https://ask.dcloud.net.cn/article/94#runmode">manifest.json的runmode配置</a>

<h3>平台支持</h3>
<ul><li>Android - ALL (支持) : 应用资源默认在apk的assets目录中，安装到设备后无法通过5+ API操作。为了能够正常枚举访问此目录，需要将应用设置为释放资源模式（在manifest.json中将runmode值设置为liberate）， 这样程序在第一次运行时将资源释放到应用Android系统应用内部存储目录（通常为“/storage/emulated/0/Android/data/%PACKAGENAME%/”，其中%PACKAGENAME%是程序的包名）下的 “apps%APPID%/www”，其中%APPID%是应用的标识。 </li><li>iOS - ALL (支持) : 应用资源默认在应用沙盒目录下的“/DCloud_Pandora.app/Pandora/apps/%APPID%/www”中， 如将应用设置为释放资源模式（在manifest.json中将runmode值设置为liberate），程序在第一次运行时将资源释放到iOS系统应用沙盒目录下的“/Library/Pandora/apps/%APPID%/www”， 其中%APPID%是应用的标识。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>File Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
plus.io.requestFileSystem( plus.io.PRIVATE_WWW, function( fs ) {
// 可通过fs操作PRIVATE_WWW文件系统 
// ......
}, function ( e ) {
alert( "Request file system failed: " + e.message );
} );
}
</script>
</head>
<body>
Local file system
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">PRIVATE_DOC</h1>
应用私有文档目录常量
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.io.PRIVATE_DOC;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
本地文件系统常量，Number类型，固定值2，对应相对路径URL为"_doc"开头的地址。应用私有文档目录，仅本应用可读写。
<h3>平台支持</h3>
<ul><li>Android - ALL (支持) : 对应Android系统应用内部存储目录（通常为“/storage/emulated/0/Android/data/%PACKAGENAME%/”，其中%PACKAGENAME%是程序的包名）下的 “apps%APPID%/doc”，其中%APPID%是应用的标识。 </li><li>iOS - ALL (支持) : 对应iOS系统应用沙盒目录下的“/Library/Pandora/apps/%APPID%/doc”，其中%APPID%是应用的标识。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>File Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
plus.io.requestFileSystem( plus.io.PRIVATE_DOC, function( fs ) {
// 可通过fs操作PRIVATE_DOC文件系统 
// ......
}, function ( e ) {
alert( "Request file system failed: " + e.message );
} );
}
</script>
</head>
<body>
Local file system
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">PUBLIC_DOCUMENTS</h1>
应用公共文档目录常量
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.io.PUBLIC_DOCUMENTS;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
本地文件系统常量，Number类型，固定值3，对应相对路径URL为"_documents"开头的地址。安装包存在多个5+ App或uni-app环境时（如小程序SDK），所有5+ App或uni-app都可进行读写操作。
<h3>平台支持</h3>
<ul><li>Android - ALL (支持) : 对应Android系统应用外部存储目录（通常为“/sdcard/Android/data/%PACKAGENAME%/”，其中%PACKAGENAME%是程序的包名）下的"documents"目录， 如HBuilder基座对应目录为“/sdcard/Android/data/io.dcloud.HBuilder/documents”。 </li><li>iOS - ALL (支持) : 对应iOS系统应用沙盒目录下的“/Library/Pandora/documents”。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>File Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
plus.io.requestFileSystem( plus.io.PUBLIC_DOCUMENTS, function( fs ) {
// 可通过fs操作PUBLIC_DOCUMENTS文件系统 
// ......
}, function ( e ) {
alert( "Request file system failed: " + e.message );
} );
}
</script>
</head>
<body>
Local file system
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">PUBLIC_DOWNLOADS</h1>
应用公共下载目录常量
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.io.PUBLIC_DOWNLOADS;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
本地文件系统常量，Number类型，固定值4，对应相对路径URL为"_downloads"开头的地址。安装包存在多个5+ App或uni-app环境时（如小程序SDK），所有5+ App或uni-app都可进行读写操作。
<h3>平台支持</h3>
<ul><li>Android - ALL (支持) : 对应Android系统应用外部存储目录（通常为“/sdcard/Android/data/%PACKAGENAME%/”，其中%PACKAGENAME%是程序的包名）下的"downloads"目录， 如HBuilder基座对应目录为“/sdcard/Android/data/io.dcloud.HBuilder/downloads”。 </li><li>iOS - ALL (支持) : 对应iOS系统应用沙盒目录下的“/Library/Pandora/downloads”。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>File Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
plus.io.requestFileSystem( plus.io.PUBLIC_DOWNLOADS, function( fs ) {
// 可通过fs操作PUBLIC_DOWNLOADS文件系统 
// ......
}, function ( e ) {
alert( "Request file system failed: " + e.message );
} );
}
</script>
</head>
<body>
Local file system
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">requestFileSystem</h1>
请求本地文件系统对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.io.requestFileSystem( type, succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取指定的文件系统，可通过type指定获取文件系统的类型。获取指定的文件系统对象成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>type: ( Number ) 必选 本地文件系统常量 可取plus.io下的常量，如plus.io.PRIVATE_DOC、plus.io.PUBLIC_DOCUMENTS等。 </li><li>succesCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileSystemSuccessCallback">FileSystemSuccessCallback</a> ) 必选 请求文件系统成功的回调 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 请求文件系统失败的回调 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>File Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
plus.io.requestFileSystem( plus.io.PRIVATE_WWW, function( fs ) {
// 可通过fs进行文件操作 
alert( "Request file system success!" );
}, function ( e ) {
alert( "Request file system failed: " + e.message );
} );
}
</script>
</head>
<body>
Request file system
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">resolveLocalFileSystemURL</h1>
通过URL参数获取目录对象或文件对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.io.resolveLocalFileSystemURL( url, succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
快速获取指定的目录或文件操作对象，如通过URL值“_www/test.html”可直接获取文件操作对象。 url值可支持相对路径URL、本地路径URL。获取指定的文件或目录操作对象成功通过succesCB回调返回，如果指定URL路径或文件不存在则失败通过errorCB回调返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>url : ( String ) 必选 要操作文件或目录的URL地址 </li><li>succesCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileResolveSuccessCallback">FileResolveSuccessCallback</a> ) 必选 获取操作文件或目录对象成功的回调函数 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 获取操作文件或目录对象失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>File Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
plus.io.resolveLocalFileSystemURL( "_www/test.html", function( entry ) {
// 可通过entry对象操作test.html文件 
entry.file( function(file){
var fileReader = new plus.io.FileReader();
alert("getFile:" + JSON.stringify(file));
fileReader.readAsText(file, 'utf-8');
fileReader.onloadend = function(evt) {
alert("11" + evt);
alert("evt.target" + evt.target);
alert(evt.target.result);
}
alert(file.size + '--' + file.name);
} );
}, function ( e ) {
alert( "Resolve file URL failed: " + e.message );
} );
}
</script>
</head>
<body>
Request file system
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">convertLocalFileSystemURL</h1>
将本地URL路径转换成平台绝对路径
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
String plus.io.convertLocalFileSystemURL( url );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
绝对路径符合各平台文件路径格式，通常用于Native.JS调用系统原生文件操作API，也可以在前面添加“file://”后在html页面中直接使用。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>url: ( String ) 必选 要转换的文件或目录URL地址 URL地址必须是合法的路径，如果地址不合法则返回null。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
String : 转换后在平台路径，在不同平台或者不同设备返回的值可能存在差异，如输入url为“_doc/a.png”： Android平台转换后的路径为“/storage/sdcard0/Android/data/io.dcloud.HBuilder/.HBuilder/apps/HBuilder/doc/ａ.png”； 在iOS平台转换后的路径为“/var/mobile/Containers/Data/Application/757966CF-345C-4348-B07F-EEF83CF9A369/Library/Pandora/apps/HBuilder/doc/a.png”。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>File Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady(){
var url="_www/index.html";
var path=plus.io.convertLocalFileSystemURL(url);
alert(path);
}
</script>
</head>
<body>
convertLocalFileSystemURL
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">convertAbsoluteFileSystem</h1>
将平台绝对路径转换成本地URL路径
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
String plus.io.convertAbsoluteFileSystem( path );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
绝对路径符合各平台文件路径格式，转换后变成RelativeURL类型格式。功能与convertLocalFileSystemURL方法相反，将绝对路径转换成相对路径。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>path: ( String ) 必选 要转换的平台绝对路径 绝对路径必须是合法的路径，如果绝对路径不合法则返回null。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
String : 转换后本地URL路径
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>File Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady(){
var url="_www/index.html";
var path=plus.io.convertLocalFileSystemURL(url);
var newurl = plus.io.convertAbsoluteFileSystem(path);
alert(newurl); // 显示值为“_www/index.html”
}
</script>
</head>
<body>
convertAbsoluteFileSystem
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getAudioInfo</h1>
获取音频文件信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.io.getAudioInfo(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
仅支持获取本地音频文件信息。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>filePath: ( String ) 必选 音频文件的路径 支持以下类型路径：
<ul style="margin-left:2em;"><li>相对路径 - 访问相对于当前页面host位置资源，如"a.mp3"</li><li>相对路径URL - 访问5+ API定义的应用沙盒目录， 参考：<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.RelativeURL">plus.io.RelativeURL</a></li><li>本地绝对路径URL - 访问应用沙盒目录外其它系统资源目录， 参考：<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.LocalURL">plus.io.LocalURL</a></li></ul> </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.IOSuccessCallback">IOSuccessCallback</a> ) 可选 获取音频文件信息成功回调函数 回调函数的参数类型为<ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.AudioInfo">AudioInfo</a>。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.IOFailCallback">IOFailCallback</a> ) 可选 获取音频文件信息失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.IOCompleteCallback">IOCompleteCallback</a> ) 可选 获取音频文件信息操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">getFileInfo</h1>
获取文件信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.io.getFileInfo(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
支持获取本地文件信息。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>filePath: ( String ) 必选 文件的路径 支持以下类型路径：
<ul style="margin-left:2em;"><li>相对路径 - 访问相对于当前页面host位置资源，如"a.mp3"</li><li>相对路径URL - 访问5+ API定义的应用沙盒目录， 参考：<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.RelativeURL">plus.io.RelativeURL</a></li><li>本地绝对路径URL - 访问应用沙盒目录外其它系统资源目录， 参考：<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.LocalURL">plus.io.LocalURL</a></li></ul> </li><li>digestAlgorithm: ( String ) 必选 计算文件摘要的算法 可取值： "md5" - 使用md5算法计算摘要信息； "sha1" - 使用sha1算法计算摘要信息。默认值为"md5"。 </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.IOSuccessCallback">IOSuccessCallback</a> ) 可选 获取文件信息成功回调函数 回调函数的参数类型为<ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileInfo">FileInfo</a>。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.IOFailCallback">IOFailCallback</a> ) 可选 获取文件信息失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.IOCompleteCallback">IOCompleteCallback</a> ) 可选 获取文件信息操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">getImageInfo</h1>
获取图片信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.io.getImageInfo(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
支持获取本地图片和网络图片的信息。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>src: ( String ) 必选 图片的路径 支持以下类型路径：
<ul style="margin-left:2em;"><li>相对路径 - 访问相对于当前页面host位置资源，如"a.mp3"</li><li>相对路径URL - 访问5+ API定义的应用沙盒目录， 参考：<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.RelativeURL">plus.io.RelativeURL</a></li><li>本地绝对路径URL - 访问应用沙盒目录外其它系统资源目录， 参考：<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.LocalURL">plus.io.LocalURL</a></li></ul> </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.IOSuccessCallback">IOSuccessCallback</a> ) 可选 获取图片信息成功回调函数 回调函数的参数类型为<ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.ImageInfo">ImageInfo</a>。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.IOFailCallback">IOFailCallback</a> ) 可选 获取图片信息失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.IOCompleteCallback">IOCompleteCallback</a> ) 可选 获取图片信息操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">getVideoInfo</h1>
获取视频文件信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.io.getVideoInfo(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
仅支持获取本地视频文件信息。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>filePath: ( String ) 必选 视频文件的路径 支持以下类型路径：
<ul style="margin-left:2em;"><li>相对路径 - 访问相对于当前页面host位置资源，如"a.mp3"</li><li>相对路径URL - 访问5+ API定义的应用沙盒目录， 参考：<ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.RelativeURL">plus.io.RelativeURL</a></li><li>本地绝对路径URL - 访问应用沙盒目录外其它系统资源目录， 参考：<ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.LocalURL">plus.io.LocalURL</a></li></ul> </li><li>success: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.IOSuccessCallback">IOSuccessCallback</a> ) 可选 获取视频文件信息成功回调函数 回调函数的参数类型为<ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.VideoInfo">VideoInfo</a>。 </li><li>fail: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.IOFailCallback">IOFailCallback</a> ) 可选 获取视频文件信息失败回调函数 </li><li>complete: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.IOCompleteCallback">IOCompleteCallback</a> ) 可选 获取视频文件信息操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">DirectoryEntry</h1>
文件系统中的目录对象，用于管理特定的本地目录
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.isFile">isFile</a>: 操作对象的是否为文件，DirectoryEntry对象固定其值为false</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.isDirectory">isDirectory</a>: 操作对象是否为目录，DirectoryEntry对象固定其值为true</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.name">name</a>: 目录操作对象的名称，不包括路径</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.fullPath">fullPath</a>: 目录操作对象的完整路径，文件系统的绝对路径</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.fileSystem">fileSystem</a>: 文件操作对象所属的文件系统对象，参考FileSystem</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.getMetadata">getMetadata</a>: 获取目录的属性</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.moveTo">moveTo</a>: 移动目录</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.copyTo">copyTo</a>: 拷贝目录</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.toURL">toURL</a>: 获取目录路径转换为URL地址</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.toLocalURL">toLocalURL</a>: 获取目录路径转换为本地路径URL地址</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.toRemoteURL">toRemoteURL</a>: 获取目录路径转换为网络路径URL地址</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.remove">remove</a>: 删除目录</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.getParent">getParent</a>: 获取目录所属的父目录</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.createReader">createReader</a>: 创建目录读取对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.getDirectory">getDirectory</a>: 创建或打开子目录</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.getFile">getFile</a>: 创建或打开文件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryEntry.removeRecursively">removeRecursively</a>: 递归删除目录</li></ul>
<h1 style="margin-left:0;">isFile</h1>
操作对象的是否为文件，DirectoryEntry对象固定其值为false
<h2 style="margin-left:.8em;">说明：</h2>
Boolean 类型只读属性
<h1 style="margin-left:0;">isDirectory</h1>
操作对象是否为目录，DirectoryEntry对象固定其值为true
<h2 style="margin-left:.8em;">说明：</h2>
Boolean 类型只读属性
<h1 style="margin-left:0;">name</h1>
目录操作对象的名称，不包括路径
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
<h1 style="margin-left:0;">fullPath</h1>
目录操作对象的完整路径，文件系统的绝对路径
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
<h1 style="margin-left:0;">fileSystem</h1>
文件操作对象所属的文件系统对象，参考FileSystem
<h2 style="margin-left:.8em;">说明：</h2>
FileSystem 类型只读属性
<h1 style="margin-left:0;">getMetadata</h1>
获取目录的属性
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.getMetadata( successCB, errorCB, recursive );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
用于获取文件或目录的属性信息。获取属性信息成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>succesCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.MetadataSuccessCallback">MetadataSuccessCallback</a> ) 必选 获取文件或目录属性信息成功的回调 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 必选 获取文件或目录属性信息失败的回调 </li><li>recursive: ( Boolean ) 必选 是否递归计算目录信息 true为递归计算获取信息，false不递归计算获取，默认值为false。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Request the metadata object for this entry
entry.getMetadata( function ( metadata ) {
plus.console.log("Last Modified: " + metadata.modificationTime);
}, function () {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">moveTo</h1>
移动目录
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.moveTo( parent, newName, succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
以下情况移动目录将会导致失败： 将父目录移动到子目录中； 要移动到的目标目录无效； 要移动到的目标路径被文件占用； 要移动到的目标目录已经存在并且不为空。移动目录成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>parent: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.DirectoryEntry">DirectoryEntry</a> ) 必选 要移动到的目标目录 </li><li>newName: ( String ) 可选 移动后的目录名称，默认为原始目录名称 </li><li>succesCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.EntrySuccessCallback">EntrySuccessCallback</a> ) 可选 移动目录成功的回调函数 回调函数中的参数保存新的目录对象。 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 移动目录失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function moveDirecty(srcEntry,dstEntry) {
var newName = document.getElementById('newName').value,

// move the directory to a new directory and rename it
srcEntry.moveTo( dstEntry, newName, function( entry ) {
plus.console.log("New Path: " + entry.fullPath);
}, function ( e ) {
alert( e.message );
} );
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">copyTo</h1>
拷贝目录
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.copyTo( parent, newName, succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
以下情况拷贝目录将会导致失败： 将父目录拷贝到子目录中； 要拷贝到的目标目录无效； 要拷贝到的目标路径被文件占用； 要拷贝到的目标目录已经存在并且不为空。拷贝目录成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>parent: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.DirectoryEntry">DirectoryEntry</a> ) 必选 要拷贝到的目标目录 </li><li>newName: ( String ) 可选 拷贝后的目录名称，默认为原始目录名称 </li><li>succesCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.EntrySuccessCallback">EntrySuccessCallback</a> ) 可选 拷贝目录成功的回调函数 回调函数中的参数保存新的目录对象。 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 拷贝目录失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function copyDirecty(srcEntry,dstEntry){
var newName = document.getElementById('newName').value,

// copy the directory to a new directory and rename it
srcEntry.copyTo( dstEntry, newName, function( entry ){
plus.console.log("New Path: " + entry.fullPath);
}, function( e ){
alert( e.message );
} );
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">toURL</h1>
获取目录路径转换为URL地址
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
String entry.toURL();
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<h2 style="margin-left:.8em;">返回值：</h2>
String : 格式为相对路径URL
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Get the URL for this directory
var dirURL = entry.toURL();
plus.console.log(dirURL);
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">toLocalURL</h1>
获取目录路径转换为本地路径URL地址
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
String entry.toLocalURL();
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<h2 style="margin-left:.8em;">返回值：</h2>
String : 格式为本地路径URL
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Get the local URL for this directory
var dirURL = entry.toLocalURL();
plus.console.log(dirURL);
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">toRemoteURL</h1>
获取目录路径转换为网络路径URL地址
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
String entry.toRemoteURL();
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<h2 style="margin-left:.8em;">返回值：</h2>
String : URL地址格式为以“http://localhost:13131/”开头的网络路径。注：仅用于网络页面访问本地资源，不推荐使用（将废弃）。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Get the remote URL for this directory
var dirURL = entry.toRemoteURL();
plus.console.log(dirURL);
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">remove</h1>
删除目录
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.remove( succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
以下情况删除目录将会导致失败： 目录中存在文件； 删除根目录； 删除目录成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>succesCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.EntrySuccessCallback">EntrySuccessCallback</a> ) 可选 删除目录成功的回调函数 回调函数中无参数。 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 删除目录失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// remove this directory
entry.remove( function ( entry ) {
plus.console.log( "Remove succeeded" );
}, function ( e ) {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getParent</h1>
获取目录所属的父目录
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.getParent( succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取父目录成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>succesCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.EntrySuccessCallback">EntrySuccessCallback</a> ) 可选 获取父目录成功的回调函数 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 获取父目录失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Get the parent DirectoryEntry
entry.getParent( function ( entry ) {
plus.console.log( "Parent Name: " + entry.name );
}, function ( e ) {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">createReader</h1>
创建目录读取对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
DirectoryReader entry.createReader();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
创建一个目录读取对象，用户读取目下的文件及子目录。
<h2 style="margin-left:.8em;">参数：</h2>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryReader">DirectoryReader</a> : 目录读取对象
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// create a directory reader
var directoryReader = entry.createReader();
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getDirectory</h1>
创建或打开子目录
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.getDirectory( path, flag, succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
创建或打开当前目录指定的目录。创建或打开目录操作成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>path: ( String ) 必选 要操作目录相对于当前目录的地址 </li><li>flag: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.Flags">Flags</a> ) 可选 要操作文件或目录的参数 </li><li>succesCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.EntrySuccessCallback">EntrySuccessCallback</a> ) 可选 创建或打开目录成功的回调函数 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 创建或打开目录失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Retrieve an existing directory, or create it if it does not already exist
entry.getDirectory( "newDir", {create:true,exclusive:false}, function( dir ){
console.log("Directory Entry Name: " + dir.name);
}, function () {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getFile</h1>
创建或打开文件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.getFile( path, flag, succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
创建或打开当前目录下指定的文件。创建或打开文件操作对象成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>path: ( String ) 必选 要操作文件相对于当前目录的地址 </li><li>flag: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.Flags">Flags</a> ) 可选 要操作文件或目录的参数 </li><li>succesCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.EntrySuccessCallback">EntrySuccessCallback</a> ) 可选 创建或打开文件成功的回调函数 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 创建或打开文件失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>File Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
plus.io.requestFileSystem( plus.io.PRIVATE_WWW, function(fs){
// fs.root是根目录操作对象DirectoryEntry
fs.root.getFile('config.xml',{create:true}, function(fileEntry){
fileEntry.file( function(file){
var fileReader = new plus.io.FileReader();
alert("getFile:" + JSON.stringify(file));
fileReader.readAsText(file, 'utf-8');
fileReader.onloadend = function(evt) {
alert("11" + evt);
alert("evt.target" + evt.target);
alert(evt.target.result);
}
alert(file.size + '--' + file.name);
} );
});
} );
}
</script>
</head>
<body>
Request file system
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">removeRecursively</h1>
递归删除目录
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.removeRecursively( succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
删除目录将会删除其下的所有文件及子目录不能删除根目录，如果操作删除根目录将会删除目录下的文件及子目录，不会删除根目录自身。删除目录成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>succesCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.EntrySuccessCallback">EntrySuccessCallback</a> ) 可选 删除目录成功的回调函数 回调函数中无参数。 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 删除目录失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// remove the directory and all it's contents
entry.removeRecursively( function ( entry ) {
plus.console.log( "Remove Recursively Succeeded" );
}, function ( e ) {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">DirectoryReader</h1>
读取目录信息对象，用于获取目录中包含的文件及子目录
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.DirectoryReader.readEntries">readEntries</a>: 获取当前目录中的所有文件和子目录</li></ul>
<h1 style="margin-left:0;">readEntries</h1>
获取当前目录中的所有文件和子目录
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
directoryReader.readEntries( succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取当前目录下的所有文件和子目录。获取操作成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>succesCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.EntrySuccessCallback">EntrySuccessCallback</a> ) 可选 获取成功的回调函数 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 获取失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>File Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
plus.io.requestFileSystem( plus.io.PRIVATE_WWW, function(fs){
// fs.root是根目录操作对象DirectoryEntry
// 创建读取目录信息对象 
var directoryReader = fs.root.createReader();
directoryReader.readEntries( function( entries ){
var i;
for( i=0; i < entries.length; i++ ) {
alert( entries[i].name );
}
}, function ( e ) {
alert( "Read entries failed: " + e.message );
} );
} );
}
</script>
</head>
<body>
Request file system
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">File</h1>
文件系统中的文件数据对象，用于获取文件的数据
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.File.size">size</a>: 文件数据对象的数据大小，单位为字节</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.File.type">type</a>: 文件数据对象MIME类型</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.File.name">name</a>: 文件数据对象的名称，不包括路径</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.File.lastModifiedDate">lastModifiedDate</a>: 文件对象的最后修改时间</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.File.slice">slice</a>: 获取文件指定的数据内容</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.File.close">close</a>: 关闭文件数据对象</li></ul>
<h1 style="margin-left:0;">size</h1>
文件数据对象的数据大小，单位为字节
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
<h1 style="margin-left:0;">type</h1>
文件数据对象MIME类型
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
<h1 style="margin-left:0;">name</h1>
文件数据对象的名称，不包括路径
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
<h1 style="margin-left:0;">lastModifiedDate</h1>
文件对象的最后修改时间
<h2 style="margin-left:.8em;">说明：</h2>
Date 类型只读属性
<h1 style="margin-left:0;">slice</h1>
获取文件指定的数据内容
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
file.slice( start, end );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取文件指定的数据内容，其中end必须大于start。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>start: ( Number ) 可选 获取文件数据的起始位置 文件起始读取Byte字节的索引值，索引值从0开始计数。 </li><li>end: ( Number ) 可选 获取文件数据的结束位置 结束读取Byte字节的索引值，索引值从0开始计数。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.File">File</a> : 指定数据内容的文件对象
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
var slice1 = file.slice(100, 400);
var slice2 = slice1.slice(20, 35);
var slice3 = file.slice(120, 135);
// slice2 and slice3 are equivalent.
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">close</h1>
关闭文件数据对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
file.close();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
当文件数据对象不再使用时，可通过此方法关闭，释放系统资源。
<h2 style="margin-left:.8em;">参数：</h2>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
var slice1 = file.slice(100, 400);
var slice2 = slice1.slice(20, 35);
var slice3 = file.slice(120, 135);
// slice2 and slice3 are equivalent.
// ......
slice3.close();
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">FileEntry</h1>
文件系统中的文件对象，用于管理特定的本地文件
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.isFile">isFile</a>: 文件操作对象的是否为文件，FileEntry对象固定其值为true</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.isDirectory">isDirectory</a>: 文件操作对象是否为目录，FileEntry对象固定其值为false</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.name">name</a>: 文件操作对象的名称，不包括路径</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.fullPath">fullPath</a>: 文件操作对象的完整路径，文件系统的绝对路径</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.fileSystem">fileSystem</a>: 文件操作对象所属的文件系统对象，参考FileSystem</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.getMetadata">getMetadata</a>: 获取文件的属性信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.moveTo">moveTo</a>: 移动文件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.copyTo">copyTo</a>: 拷贝文件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.toURL">toURL</a>: 获取文件路径转换为URL地址</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.toLocalURL">toLocalURL</a>: 获取文件路径转换为本地路径URL地址</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.toRemoteURL">toRemoteURL</a>: 获取文件路径转换为网络路径URL地址</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.remove">remove</a>: 删除文件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.getParent">getParent</a>: 获取文件所属的父目录</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.createWriter">createWriter</a>: 获取文件关联的写文件操作对象FileWriter</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEntry.file">file</a>: 获取文件数据对象</li></ul>
<h1 style="margin-left:0;">isFile</h1>
文件操作对象的是否为文件，FileEntry对象固定其值为true
<h2 style="margin-left:.8em;">说明：</h2>
Boolean 类型只读属性
<h1 style="margin-left:0;">isDirectory</h1>
文件操作对象是否为目录，FileEntry对象固定其值为false
<h2 style="margin-left:.8em;">说明：</h2>
Boolean 类型只读属性
<h1 style="margin-left:0;">name</h1>
文件操作对象的名称，不包括路径
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
<h1 style="margin-left:0;">fullPath</h1>
文件操作对象的完整路径，文件系统的绝对路径
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
<h1 style="margin-left:0;">fileSystem</h1>
文件操作对象所属的文件系统对象，参考FileSystem
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileSystem">FileSystem</a> 类型只读属性
<h1 style="margin-left:0;">getMetadata</h1>
获取文件的属性信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.getMetadata( successCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
用于获取文件的属性信息。获取属性信息成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>succesCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.MetadataSuccessCallback">MetadataSuccessCallback</a> ) 必选 获取文件属性信息成功的回调函数 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 必选 获取文件属性信息失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Request the metadata object for this entry
entry.getMetadata( function ( metadata ) {
plus.console.log("Last Modified: " + metadata.modificationTime);
}, function () {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">moveTo</h1>
移动文件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.moveTo( parent, newName, succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
以下情况移动目录将会导致失败： 要移动到的目标目录无效； 要移动到的目标路径被其它文件占用； 移动文件成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>parent: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.DirectoryEntry">DirectoryEntry</a> ) 必选 要移动到的目标目录 </li><li>newName: ( String ) 可选 移动后的文件名称，默认为原始文件名称 </li><li>succesCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.EntrySuccessCallback">EntrySuccessCallback</a> ) 可选 移动文件成功的回调函数 回调函数中的参数保存新的文件对象。 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 移动文件失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function moveFile(fileEntry,dstEntry){
// move the file to a new directory and rename it
fileEntry.moveTo( dstEntry, "newfile.txt", function( entry ){
plus.console.log("New Path: " + entry.fullPath);
}, function( e ){
alert( e.message );
} );
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">copyTo</h1>
拷贝文件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.copyTo( parent, newName, succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
以下情况拷贝文件将会导致失败： 要拷贝到的目标目录无效； 要拷贝到的目标路径被其它文件占用； 拷贝文件成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>parent: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.DirectoryEntry">DirectoryEntry</a> ) 必选 要拷贝到的目标目录 </li><li>newName: ( String ) 可选 拷贝后的文件名称，默认为原始文件名称 </li><li>succesCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.EntrySuccessCallback">EntrySuccessCallback</a> ) 可选 拷贝文件成功的回调函数 回调函数中的参数保存新的文件对象。 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 拷贝文件失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function copyFile(fileEntry,dstEntry) {
// copy the file to a new directory and rename it
fileEntry.copyTo( dstEntry, "file.copy", function( entry ){
plus.console.log("New Path: " + entry.fullPath);
}, function( e ){
alert( e.message );
} );
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">toURL</h1>
获取文件路径转换为URL地址
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
String entry.toURL();
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<h2 style="margin-left:.8em;">返回值：</h2>
String : 格式为相对路径URL
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Get the URL for this file
var fileURL = entry.toURL();
plus.console.log(fileURL);
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">toLocalURL</h1>
获取文件路径转换为本地路径URL地址
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
String entry.toLocalURL();
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<h2 style="margin-left:.8em;">返回值：</h2>
String : 格式为本地路径URL
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Get the local URL for this file
var fileURL = entry.toLocalURL();
plus.console.log(dirURL);
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">toRemoteURL</h1>
获取文件路径转换为网络路径URL地址
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
String entry.toRemoteURL();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
URL地址格式为以“http://localhost:13131/”开头的网络路径。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
String : 网络格式路径URL
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Get the remote URL for this file
var fileURL = entry.toRemoteURL();
plus.console.log(dirURL);
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">remove</h1>
删除文件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.remove( succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
删除文件成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>succesCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.EntrySuccessCallback">EntrySuccessCallback</a> ) 可选 删除文件成功的回调函数 回调函数中无参数。 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 删除文件失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// remove this file
entry.remove( function ( entry ) {
plus.console.log( "Remove succeeded" );
}, function ( e ) {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getParent</h1>
获取文件所属的父目录
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.getParent( succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取父目录成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>succesCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.EntrySuccessCallback">EntrySuccessCallback</a> ) 可选 获取父目录成功的回调函数 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 获取父目录失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Get the parent DirectoryEntry
entry.getParent( function ( entry ) {
plus.console.log( "Parent Name: " + entry.name );
}, function ( e ) {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">createWriter</h1>
获取文件关联的写文件操作对象FileWriter
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.createWriter( succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取写文件操作对象成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>succesCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriterSuccessCallback">FileWriterSuccessCallback</a> ) 可选 获取写文件操作对象成功的回调函数 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 获取写文件操作对象失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// create a FileWriter to write to the file
entry.createWriter( function ( writer ) {
// Write data to file.
writer.write( "Data " );
}, function ( e ) {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">file</h1>
获取文件数据对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
entry.file( succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取文件数据对象成功通过succesCB回调返回，失败则通过errorCB返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>succesCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileSuccessCallback">FileSuccessCallback</a> ) 可选 获取文件数据对象成功的回调函数 </li><li>errorCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileErrorCallback">FileErrorCallback</a> ) 可选 获取文件数据对象失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Get the parent DirectoryEntry
entry.file( function ( file ) {
plus.console.log("File size: " + file.size);
}, function ( e ) {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">FileReader</h1>
文件系统中的读取文件对象，用于获取文件的内容
<h2 style="margin-left:.8em;">说明：</h2>
FileReader对象是从设备文件系统读取文件FileReader对象是从设备文件系统读取文件的一种方式，文件以文本或者Base64编码的字符串形式读出来。用户注册自己的事件监听器来接收loadstart、progress、load、loadend、error和abort事件。
<h2 style="margin-left:.8em;">构造：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.FileReader">FileReader</a>: 创建读取文件对象</li></ul>
<h2 style="margin-left:.8em;">常量：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.EMPTY">EMPTY</a>: 值为0，开始读取文件状态</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.LOADING">LOADING</a>: 值为1，正在读取文件状态</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.DONE">DONE</a>: 值为2，读文件操作完成状态</li></ul>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.readyState">readyState</a>: 当前读取文件所处的状态</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.result">result</a>: 已读取文件的内容</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.error">error</a>: 文件操作错误代码</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.abort">abort</a>: 终止文件读取操作</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.readAsDataURL">readAsDataURL</a>: 以URL编码格式读取文件数据内容</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.readAsText">readAsText</a>: 以文本格式读取文件数据内容</li></ul>
<h2 style="margin-left:.8em;">事件：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.onloadstart">onloadstart</a>: 读取文件开始时的回调函数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.onload">onload</a>: 读取文件成功完成的回调函数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.onabort">onabort</a>: 取消读取文件时的回调函数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.onerror">onerror</a>: 文件读取操作失败时调用的回调函数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileReader.onloadend">onloadend</a>: 文件读取操作完成时的回调函数</li></ul>
<h1 style="margin-left:0;">FileReader</h1>
创建读取文件对象
<h2 style="margin-left:.8em;">说明：</h2>
创建读取文件对象
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileReader">FileReader</a> :
<h1 style="margin-left:0;">EMPTY</h1>
值为0，开始读取文件状态
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
<h1 style="margin-left:0;">LOADING</h1>
值为1，正在读取文件状态
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
<h1 style="margin-left:0;">DONE</h1>
值为2，读文件操作完成状态
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
<h1 style="margin-left:0;">readyState</h1>
当前读取文件所处的状态
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
可取上面定义的常量值，EMPTY（0）、LOADING（1）、DONE（2）。
<h1 style="margin-left:0;">result</h1>
已读取文件的内容
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
<h1 style="margin-left:0;">error</h1>
文件操作错误代码
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
<h1 style="margin-left:0;">abort</h1>
终止文件读取操作
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
reader.abort();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
读取文件操作开始后，可通过此方法取消读取文件。调用此方法后将触发文件读取对象的onabort事件。
<h2 style="margin-left:.8em;">参数：</h2>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Read data from file
var reader = null;
entry.file( function ( file ) {
reader = new plus.io.FileReader();
reader.onloadend = function ( e ) {
plus.console.log( "Read success" );
// Get data
plus.console.log( e.target.result );
};
reader.readAsText( file );
}, function ( e ) {
alert( e.message );
} );

// ......
// Abort read data from file
reader.abort();
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">readAsDataURL</h1>
以URL编码格式读取文件数据内容
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
reader.readAsDataURL( file, encoding );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
读取文件的数据内容，并将数据内容进行URL编码。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>file: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.File">File</a> ) 必选 要读取的文件数据对象 </li><li>encoding : ( String ) 可选 读取文件数据内容的字符编码格式 目前仅支持UTF-8编码格式。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Read data from file
var reader = null;
entry.file( function ( file ) {
reader = new plus.io.FileReader();
reader.onloadend = function ( e ) {
plus.console.log( "Read success" );
// Get data
plus.console.log( e.target.result );
};
reader.readAsDataURL( file );
}, function ( e ) {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">readAsText</h1>
以文本格式读取文件数据内容
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
reader.readAsText( file, encoding );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
读取文件的数据内容。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>file: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.File">File</a> ) 必选 要读取的文件数据对象 </li><li>encoding : ( String ) 可选 读取文件数据内容的字符编码格式 目前仅支持UTF-8编码格式。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Read data from file
var reader = null;
entry.file( function ( file ) {
reader = new plus.io.FileReader();
reader.onloadend = function ( e ) {
plus.console.log( "Read success" );
// Get data
plus.console.log( e.target.result );
};
reader.readAsText( file );
}, function ( e ) {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">onloadstart</h1>
读取文件开始时的回调函数
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileEventCallback">FileEventCallback</a> 类型
<h1 style="margin-left:0;">onload</h1>
读取文件成功完成的回调函数
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileEventCallback">FileEventCallback</a> 类型
<h1 style="margin-left:0;">onabort</h1>
取消读取文件时的回调函数
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileEventCallback">FileEventCallback</a> 类型
<h1 style="margin-left:0;">onerror</h1>
文件读取操作失败时调用的回调函数
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileEventCallback">FileEventCallback</a> 类型
<h1 style="margin-left:0;">onloadend</h1>
文件读取操作完成时的回调函数
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileEventCallback">FileEventCallback</a> 类型
不管成功或失败都会触发。
<h1 style="margin-left:0;">FileWriter</h1>
文件系统中的写文件对象，用于写入文件内容
<h2 style="margin-left:.8em;">说明：</h2>
FileWriter对象是向设备文件系统写入文件的一种方式，用户注册自己的事件监听器来接收writestart、progress、write、writeend、error和abort事件。一个FileWriter对象是为单个文件的操作而创建，可以使用该对象多次对相应文件进行写入操作。 FileWriter维护该文件的指针位置及长度属性，这样就可以寻找和写入文件的任何地方。默认情况下，FileWriter从文件的开头开始写入（将覆盖现有数据），seek方法可设置文件操作指定位置，如fw.seek(fw.length-1)写入操作就会从文件的末尾开始。
<h2 style="margin-left:.8em;">常量：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.INIT">INIT</a>: 值为0，写文件初始化状态</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.WRITING">WRITING</a>: 值为1，正在写入文件状态</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.DONE">DONE</a>: 值为2，写文件操作完成状态</li></ul>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.readyState">readyState</a>: 当前写入文件所处的状态</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.length">length</a>: 文件当前的长度，单位为字节</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.position">position</a>: 文件当前操作的指针位置</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.error">error</a>: 文件写入操作错误代码</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.abort">abort</a>: 终止文件写入操作</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.seek">seek</a>: 定位文件操作位置</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.truncate">truncate</a>: 按照指定长度截断文件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.write">write</a>: 向文件中写入数据</li></ul>
<h2 style="margin-left:.8em;">事件：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.onwritestart">onwritestart</a>: 写入文件开始时的回调函数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.onwrite">onwrite</a>: 写入文件成功完成的回调函数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.onabort">onabort</a>: 取消写入文件时的回调函数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.onerror">onerror</a>: 文件写入操作失败时调用的回调函数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileWriter.onwriteend">onwriteend</a>: 文件写入操作完成时的回调函数</li></ul>
<h1 style="margin-left:0;">INIT</h1>
值为0，写文件初始化状态
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
<h1 style="margin-left:0;">WRITING</h1>
值为1，正在写入文件状态
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
<h1 style="margin-left:0;">DONE</h1>
值为2，写文件操作完成状态
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
<h1 style="margin-left:0;">readyState</h1>
当前写入文件所处的状态
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
可取上面定义的常量值，INIT(0)、WRITING（1）、DONE（2）。
<h1 style="margin-left:0;">length</h1>
文件当前的长度，单位为字节
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
<h1 style="margin-left:0;">position</h1>
文件当前操作的指针位置
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
<h1 style="margin-left:0;">error</h1>
文件写入操作错误代码
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
<h1 style="margin-left:0;">abort</h1>
终止文件写入操作
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
writer.abort();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
写入文件数据操作开始后，可通过此方法取消写入文件数据操作。调用此方法后将触发文件写入对象的onabort事件。
<h2 style="margin-left:.8em;">参数：</h2>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Write data to file
var w = null;
entry.createWriter( function ( writer ) {
w = writer;
// fast forwards file pointer to end of file
writer.seek( writer.length-1 );
}, function ( e ) {
alert( e.message );
} );

// ......
// Abort write data to file
w.abort();
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">seek</h1>
定位文件操作位置
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
writer.seek( position );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
定位文件的操作位置，有效值为0到文件的总长度减1。 0表示文件的起始位置。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>position: ( Number ) 必选 要定位到的位置 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Write data to file
var w = null;
entry.createWriter( function ( writer ) {
w = writer;
// fast forwards file pointer to end of file
writer.seek( writer.length-1 );
}, function ( e ) {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">truncate</h1>
按照指定长度截断文件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
writer.truncate( length );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
从文件当前定位的位置开始，按照指定长度截断文件。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>length : ( Number ) 必选 截断后的文件长度 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Truncate file
entry.createWriter( function ( writer ) {
// Truncate file data length to 100
writer.truncate( 100 );
}, function ( e ) {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">write</h1>
向文件中写入数据
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
writer.write( data );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
从文件当前定位的位置开始，写入数据到文件中。如果文件中已经存在数据，新写入的数据将覆盖已有数据。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>data : ( String ) 必选 要写入的数据内容 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// Write data to file
entry.createWriter( function ( writer ) {
writer.onwrite = function ( e ) {
plus.console.log( "Write data success!" );
};
// Write data to the end of file.
writer.seek( writer.length );
writer.write( "New data!" );
}, function ( e ) {
alert( e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">onwritestart</h1>
写入文件开始时的回调函数
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileEventCallback">FileEventCallback</a> 类型
<h1 style="margin-left:0;">onwrite</h1>
写入文件成功完成的回调函数
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileEventCallback">FileEventCallback</a> 类型
<h1 style="margin-left:0;">onabort</h1>
取消写入文件时的回调函数
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileEventCallback">FileEventCallback</a> 类型
<h1 style="margin-left:0;">onerror</h1>
文件写入操作失败时调用的回调函数
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileEventCallback">FileEventCallback</a> 类型
<h1 style="margin-left:0;">onwriteend</h1>
文件写入操作完成时的回调函数
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileEventCallback">FileEventCallback</a> 类型
不管成功或失败都会触发。
<h1 style="margin-left:0;">FileSystem</h1>
文件系统对象，用于管理特定本地文件目录
<h2 style="margin-left:.8em;">说明：</h2>
文件系统对象表示一个应用可访问的根目录。name属性用于标识此根目录的名称，与LocalFileSystem中的文件系统类型一一对应。root属性为文件目录对象，用于实际操作文件系统，参考DirectoryEntry。
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileSystem.name">name</a>: 文件系统的名称</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122819151#plus.io.FileSystem.root">root</a>: 文件系统的根目录</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>File Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
plus.io.requestFileSystem( plus.io.PRIVATE_WWW, function( fs ) {
// 可通过fs进行文件操作 
alert( "File system name: " + fs.name );
// 通过fs.root获取DirectoryEntry对象进行操作 
// fs.root 
}, function ( e ) {
alert( "Request file system failed: " + e.message );
} );
}
</script>
</head>
<body>
Request file system
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">name</h1>
文件系统的名称
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
值为文件系统类型常量值字符串，如“PRIVATE_WWW”、“PRIVATE_DOCUMENTS”。
<h1 style="margin-left:0;">root</h1>
文件系统的根目录
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.DirectoryEntry">DirectoryEntry</a> 类型只读属性
<h1 style="margin-left:0;">Flags</h1>
JSON对象，获取文件操作的参数
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>create: (Boolean 类型 )是否创建对象标记 指示如果文件或目录不存在时是否进行创建，默认值为false。 </li><li>exclusive: (Boolean 类型 )反向操作标记 其本身没有任何效果，需与create属性值设置为true时一起使用，如果目标文件或目录已经存在则会导致文件或目录打开失败，默认值为false。 </li></ul>
<h1 style="margin-left:0;">Metadata</h1>
JSON对象，保存文件或目录的状态信息对象
<h2 style="margin-left:.8em;">说明：</h2>
可通过DirectoryEntry或FileEntry对象的getMetaData方法获取
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>modificationTime: (Date 类型 )文件或目录的最后修改时间</li><li>size: (Number 类型 )文件的大小 若获取的是目录对象的属性则值为0。 </li><li>directoryCount: (Number 类型 )包含的子目录数 若自身是文件则其值为0。 </li><li>fileCount: (Number 类型 )目录的文件数 若自身是文件则其值为0。 </li></ul>
<h1 style="margin-left:0;">FileEvent</h1>
文件或目录操作事件对象
<h2 style="margin-left:.8em;">说明：</h2>
所有文件或目录操作事件回调函数中都创建该对象的实例。该对象从DOMEvent继承而来，可通过该其target属性获取事件触发的文件或目录操作对象。
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>target: (<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.DirectoryEntry">DirectoryEntry</a> 类型 )文件或目录操作对象 在不同的回调中指向的对象不同，可指向的对象包括：FileEntry、DirectoryEntry、FileReader、FileWriter。 </li></ul>
<h1 style="margin-left:0;">RelativeURL</h1>
相对路径URL
<h2 style="margin-left:.8em;">说明：</h2>
用于访问5+ API中定义的应用沙盒目录，以“_”开头。
<h2 style="margin-left:.8em;">常量：</h2>
<ul><li>"_www": (String 类型 )应用私有资源目录 对应常量<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.PRIVATE_WWW">plus.io.PRIVATE_WWW</a>，仅应用自身可读。保存应用的所有html、css、js等资源文件，“_www”后面加资源相对路径，如“_www/res/icon.png”。 注意：应用资源目录是只读目录，只能读取此目录下的文件，不能修改或新建。 </li><li>"_doc": (String 类型 )应用私有文档目录 对应常量<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.PRIVATE_DOC">plus.io.PRIVATE_DOC</a>，仅应用自身可读写。用于保存应用运行期业务逻辑数据，“_doc”后面加资源相对路径，如“_doc/userdata.json”。 </li><li>"_documents": (String 类型 )程序公用文档目录 对应常量<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.PUBLIC_DOCUMENTS">plus.io.PUBLIC_DOCUMENTS</a>，多应用时都可共享读写。用于保存程序中各应用间可共享文件的目录，“_document”后面加资源相对路径，如“_document/share.doc”。 </li><li>"_downloads": (String 类型 )程序公用下载目录 对应常量<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.PUBLIC_DOWNLOADS">plus.io.PUBLIC_DOWNLOADS</a>，多应用时都可共享读写。用于保存程序中各应用间可共享的下载文件目录，“_download”后面加资源相对路径，，如“_download/mydoc.doc”。 </li></ul>
<h1 style="margin-left:0;">LocalURL</h1>
本地绝对路径URL
<h2 style="margin-left:.8em;">说明：</h2>
可在html页面中直接访问本地文件系统资源，以“file://”开头，后面跟随系统的绝对路径。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - ALL (支持) : 如Android平台公共目录文件系统绝对路径为“/storage/emulated/0/DCIM/a.jpg”，对应的本地绝对路径URL为“file:///storage/emulated/0/DCIM/a.jpg”。 注意：Android10及以上系统对公共目录文件的访问有更严格的限制，详情参考：<ahref="https://ask.dcloud.net.cn/article/36199#io">Android平台适配分区存储机制注意事项</a> </li><li>iOS - ALL (支持) : 如iOS平台绝对路径为“/var/mobile/Containers/Data/Application/757966CF-345C-4348-B07F-EEF83CF9A369/Library/Pandora/apps/HBuilder/doc/a.png”， 对应的本地绝对路径URL为“file:///var/mobile/Containers/Data/Application/757966CF-345C-4348-B07F-EEF83CF9A369/Library/Pandora/apps/HBuilder/doc/a.png”。其中“/var/mobile/Containers/Data/Application/757966CF-345C-4348-B07F-EEF83CF9A369/”为iOS应用沙盒目录，安装后由系统分配。 注意：系统限制应用只能访问iOS应用沙盒目录，不能访问系统其它目录，绝地路径可用于访问5+ API定义的应用沙盒目录外的资源。 </li></ul>
<h1 style="margin-left:0;">RemoteURL</h1>
网络路径URL
<h2 style="margin-left:.8em;">说明：</h2>
可在html页面中以网络资源模式访问本地资源，以“http://”开头，后面跟随相对路径。如“http://www.dcloud.io/icon.png”。
<h1 style="margin-left:0;">AudioInfo</h1>
JSON对象，音频文件信息对象
<h2 style="margin-left:.8em;">说明：</h2>
通过getAudioInfo方法的成功回调函数返回
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>duration: (Number 类型 )音频长度 单位为秒（s）。 </li></ul>
<h1 style="margin-left:0;">FileInfo</h1>
JSON对象，文件信息对象
<h2 style="margin-left:.8em;">说明：</h2>
通过getFileInfo方法的成功回调函数返回
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>digest: (String 类型 )文件摘要 按照传入的 digestAlgorithm 计算得出的文件摘要信息。 </li><li>size: (Number 类型 )文件大小 单位为字节。 </li></ul>
<h1 style="margin-left:0;">ImageInfo</h1>
JSON对象，图片信息对象
<h2 style="margin-left:.8em;">说明：</h2>
通过getImageInfo方法的成功回调函数返回
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>height: (Number 类型 )图片的原始高度 若获取的是目录对象的属性则值为0。 </li><li>orientation: (String 类型 )拍照时设备方向信息 可取值： "up" - 默认方向（手机横持拍照），对应 Exif 中的 1，或无 orientation 信息； "up-mirrored" - 同 up，但镜像翻转，对应 Exif 中的 2； "down" - 旋转180度，对应 Exif 中的 3； "down-mirrored" - 同 down，但镜像翻转，对应 Exif 中的 4； "left-mirrored" - 同 left，但镜像翻转，对应 Exif 中的 5； "right" - 顺时针旋转90度，对应 Exif 中的 6； "right-mirrored" - 同 right，但镜像翻转，对应 Exif 中的 7； "left" - 逆时针旋转90度，对应 Exif 中的 8。更多详情参考图片扩展中的方向信息：http://sylvana.net/jpegcrop/exif_orientation.html。 </li><li>path: (String 类型 )图片的本地路径 绝对路径，以"file://"开头。 </li><li>type: (String 类型 )图片格式</li><li>width: (Number 类型 )图片的原始宽度 单位为像素（px），不考虑旋转。 </li></ul>
<h1 style="margin-left:0;">VideoInfo</h1>
JSON对象，视频文件信息对象
<h2 style="margin-left:.8em;">说明：</h2>
通过getVideoInfo方法的成功回调函数返回
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>bitrate: (Number 类型 )视频码率 单位为kbps。 注意：HBuilderX3.1.14+版本支持。 </li><li>duration: (Number 类型 )视频长度 单位为秒（s）。 </li><li>height: (Number 类型 )视频高度 视频的真实像素值高度。 </li><li>orientation: (String 类型 )画面方向 取值范围：
<ul style="margin-left:2em;"><li>up - 表示正常方向</li><li>down - 表示方向旋转180度</li><li>left - 表示方向逆时针旋转90度</li><li>right - 表示方向顺时针旋转90度</li></ul> 注意：HBuilderX3.1.14+版本支持。 </li><li>resolution: (String 类型 )视频分辨率 格式为“宽*高”，如“1280*720”。 </li><li>size: (Number 类型 )文件大小 单位为字节。 </li><li>type: (String 类型 )视频格式 注意：HBuilderX3.1.14+版本支持。 </li><li>width: (Number 类型 )视频宽度 视频的真实像素值宽度。 </li></ul>
<h1 style="margin-left:0;">FileEventCallback</h1>
文件事件回调
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onEvent( event ) {
// Event code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
文件或目录操作回调事件。通常在FileReader和FileWriter对象的事件函数中触发。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileEvent">FileEvent</a> ) 必选 文件事件对象 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">FileSystemSuccessCallback</h1>
请求文件系统成功的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess( fs ) {
// File System operate code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>fs: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileSystem">FileSystem</a> ) 必选 请求到的文件系统对象 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">FileResolveSuccessCallback</h1>
通过URL参数获取目录或文件对象成功的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess( entry ) {
// File or Direcory entry operate code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>entry: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.DirectoryEntry">DirectoryEntry</a> ) 必选 请求到的目录或文件对象 可指向文件或目录对象（DirectoryEntry|FileEntry）。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">MetadataSuccessCallback</h1>
获取文件或目录状态信息成功的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess( metadata ) {
// Metadata code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>metadata: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.Metadata">Metadata</a> ) 必选 文件或目录的状态信息 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">EntrySuccessCallback</h1>
操作文件或目录对象成功的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess( entry ) {
// Entry code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>entry: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.DirectoryEntry">DirectoryEntry</a> ) 必选 文件或目录对象的引用 可指向文件或目录对象（DirectoryEntry|FileEntry）。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">EntrysSuccessCallback</h1>
操作文件或目录对象数组成功的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess( entrys ) {
// Entrys code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>entrys: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.DirectoryEntry">DirectoryEntry</a> ) 必选 文件或目录对象数组 可指向文件或目录对象数组（DirectoryEntry[]|FileEntry[]）。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">FileWriterSuccessCallback</h1>
写文件操作成功的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess( writer ) {
// FileWriter code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>writer: ( <ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.FileWriter">FileWriter</a> ) 必选 写文件对象的引用 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">FileSuccessCallback</h1>
文件操作成功的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess( file ) {
// file code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>file: ( File ) 必选 文件数据对象的引用 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">FileErrorCallback</h1>
文件操作失败的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onError( error ) {
// Error code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>error: ( Exception ) 必选 文件操作失败的信息 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">IOSuccessCallback</h1>
成功回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess(event){
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
不同接口触发的成功回调参数event包含的属性存在差异，具体参考对应的接口描述说明。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 必选 回调参数 回调参数包含的属性由调用接口决定，具体参考对应的接口描述说明。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">IOFailCallback</h1>
失败回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onFail(Exception error){
// Handle error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>error: ( Exception ) 必选 回调参数，错误信息 可通过error.code（Number类型）获取错误编码； 可通过error.message（String类型）获取错误描述信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">IOCompleteCallback</h1>
操作完成回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onComplete(event){
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用成功或失败都会触发此回调。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 可选 回调参数 调用成功时回调参数与IOSuccessCallback一致，调用失败时回调参数与IOFailCallback一致。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

宜信同城网交流论坛's Archiver

IO模块管理本地文件系统，用于对文件系统的目录浏览、文件的读取、文件的写入等操作。 ...