w-ftp 1.0.3 → 1.0.4

package/docs/index.html

@@ -27,7 +27,7 @@
 
 <nav >
     
-    <h2><a href="index.html">Home</a></h2><h3>Global</h3><ul><li><a href="global.html#ftpCheckFile">ftpCheckFile</a></li><li><a href="global.html#ftpConn">ftpConn</a></li><li><a href="global.html#ftpDownload">ftpDownload</a></li><li><a href="global.html#ftpLs">ftpLs</a></li><li><a href="global.html#ftpQuit">ftpQuit</a></li><li><a href="global.html#ftpStateFile">ftpStateFile</a></li><li><a href="global.html#ftpSyncToLocal">ftpSyncToLocal</a></li><li><a href="global.html#ftpSyncToRemote">ftpSyncToRemote</a></li><li><a href="global.html#ftpUpload">ftpUpload</a></li><li><a href="global.html#WFtp">WFtp</a></li></ul>
+    <h2><a href="index.html">Home</a></h2><h3>Global</h3><ul><li><a href="global.html#conn">conn</a></li><li><a href="global.html#download">download</a></li><li><a href="global.html#isFile">isFile</a></li><li><a href="global.html#isFolder">isFolder</a></li><li><a href="global.html#ls">ls</a></li><li><a href="global.html#quit">quit</a></li><li><a href="global.html#stateFile">stateFile</a></li><li><a href="global.html#syncToLocal">syncToLocal</a></li><li><a href="global.html#syncToRemote">syncToRemote</a></li><li><a href="global.html#upload">upload</a></li><li><a href="global.html#WFtp">WFtp</a></li></ul>
 </nav>
 
 <div id="main">
@@ -68,7 +68,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.6.10</a> on Sat Jul 23 2022 21:57:53 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.6.10</a> on Sun Jul 24 2022 12:32:49 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/jsftp.js.html

@@ -27,7 +27,7 @@
 
 <nav >
     
-    <h2><a href="index.html">Home</a></h2><h3>Global</h3><ul><li><a href="global.html#ftpCheckFile">ftpCheckFile</a></li><li><a href="global.html#ftpConn">ftpConn</a></li><li><a href="global.html#ftpDownload">ftpDownload</a></li><li><a href="global.html#ftpLs">ftpLs</a></li><li><a href="global.html#ftpQuit">ftpQuit</a></li><li><a href="global.html#ftpStateFile">ftpStateFile</a></li><li><a href="global.html#ftpSyncToLocal">ftpSyncToLocal</a></li><li><a href="global.html#ftpSyncToRemote">ftpSyncToRemote</a></li><li><a href="global.html#ftpUpload">ftpUpload</a></li><li><a href="global.html#WFtp">WFtp</a></li></ul>
+    <h2><a href="index.html">Home</a></h2><h3>Global</h3><ul><li><a href="global.html#conn">conn</a></li><li><a href="global.html#download">download</a></li><li><a href="global.html#isFile">isFile</a></li><li><a href="global.html#isFolder">isFolder</a></li><li><a href="global.html#ls">ls</a></li><li><a href="global.html#quit">quit</a></li><li><a href="global.html#stateFile">stateFile</a></li><li><a href="global.html#syncToLocal">syncToLocal</a></li><li><a href="global.html#syncToRemote">syncToRemote</a></li><li><a href="global.html#upload">upload</a></li><li><a href="global.html#WFtp">WFtp</a></li></ul>
 </nav>
 
 <div id="main">
@@ -626,7 +626,7 @@ Ftp.prototype.put = function(from, destination, callback) {
             // })
 
             socket.on('drain', () => {
-                console.log('drain')
+                // console.log('drain')
                 if (from.length > pointer + SLICE) {
                     newBuf = from.slice(pointer, pointer + SLICE)
                     pointer += SLICE
@@ -811,11 +811,14 @@ Ftp.prototype.getPasvSocket = function(callback = NOOP) {
  */
 Ftp.prototype.ls = function(filePath, callback) {
     function entriesToList(err, entries) {
+        // console.log('entriesToList', err, entries)
         if (err) {
             return callback(err)
         }
 
+        //ListingParser.parseFtpEntries是基於parse-listing解析, 但原始數據是ls而來, 本身就沒有到秒, 故只有類似dir提供的粗略時間, 無法像fs.statSync提供精確的產生與最新變更時間
         ListingParser.parseFtpEntries(entries.text || entries, (err, files) => {
+            // console.log('ListingParser.parseFtpEntries', err, files)
             if (err) {
                 return callback(err)
             }
@@ -834,6 +837,7 @@ Ftp.prototype.ls = function(filePath, callback) {
     }
     else {
         this.raw('stat', filePath, (err, data) => {
+            // console.log('filePath', filePath, data)
             // We might be connected to a server that doesn't support the
             // 'STAT' command, which is set as default. We use 'LIST' instead,
             // and we set the variable `useList` to true, to avoid extra round
@@ -912,7 +916,7 @@ module.exports = Ftp
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.6.10</a> on Sat Jul 23 2022 21:57:53 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.6.10</a> on Sun Jul 24 2022 12:32:49 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/g-download.mjs

@@ -24,18 +24,32 @@ async function test_dw() {
         password: st.dw.password,
     })
 
-    let fps = await ftp.ls('.')
-    console.log('ftp.ls', fps[0], fps.length)
+    async function core() {
 
-    r = await ftp.download('./DECL_20210805055044.csv', './_test_download_client/DECL_20210805055044.csv', (p) => {
-        console.log('ftp.download p', p.name, p.progress)
-    })
-    console.log('ftp.download', r)
+        let fps = await ftp.ls('.')
+        console.log('ftp.ls', fps[0], fps.length)
 
-    r = await ftp.syncToLocal('.', './_test_download_client', (p) => {
-        console.log('ftp.syncToLocal p', p.name, p.progress)
-    })
-    console.log('ftp.syncToLocal', r)
+        r = await ftp.isFile('./DECL_20210805055044.csv')
+        console.log('ftp.isFile', r)
+
+        r = await ftp.isFolder('./DECL_20210805055044.csv')
+        console.log('ftp.isFolder', r)
+
+        r = await ftp.download('./DECL_20210805055044.csv', './_test_download_client/DECL_20210805055044.csv', (p) => {
+            console.log('ftp.download p', p.name, p.progress)
+        })
+        console.log('ftp.download', r)
+
+        r = await ftp.syncToLocal('.', './_test_download_client', (p) => {
+            console.log('ftp.syncToLocal p', p.name, p.progress)
+        })
+        console.log('ftp.syncToLocal', r)
+
+    }
+    await core()
+        .catch((err) => {
+            console.log(err)
+        })
 
     r = await ftp.quit()
     console.log('ftp.quit', r)
@@ -56,6 +70,8 @@ test_dw()
 //   groupPermissions: { read: true, write: true, exec: false },
 //   otherPermissions: { read: true, write: true, exec: false }
 // } 74
+// ftp.isFile false
+// ftp.isFolder false
 // ftp.download p DECL_20210805055044.csv 4.7320871554333515
 // ftp.download p DECL_20210805055044.csv 9.464174310866703
 // ftp.download p DECL_20210805055044.csv 14.196261466300053

package/g-upload.mjs

@@ -24,18 +24,32 @@ async function test_up() {
         password: st.up.password,
     })
 
-    let fps = await ftp.ls('.')
-    console.log('ftp.ls', fps[0], fps.length)
+    async function core() {
 
-    r = await ftp.upload('./_test_upload_client/DECL_20210805055044.csv', './DECL_20210805055044.csv', (p) => {
-        console.log('ftp.upload p', p.name, p.progress)
-    })
-    console.log('ftp.upload', r)
+        let fps = await ftp.ls('.')
+        console.log('ftp.ls', fps[0], fps.length)
 
-    r = await ftp.syncToRemote('./_test_upload_client', '.', (p) => {
-        console.log('ftp.syncToRemote p', p.name, p.progress)
-    })
-    console.log('ftp.syncToRemote', r)
+        r = await ftp.isFile('./DECL_20210805055044.csv')
+        console.log('ftp.isFile', r)
+
+        r = await ftp.isFolder('./DECL_20210805055044.csv')
+        console.log('ftp.isFolder', r)
+
+        r = await ftp.upload('./_test_upload_client/DECL_20210805055044.csv', './DECL_20210805055044.csv', (p) => {
+            console.log('ftp.upload p', p.name, p.progress)
+        })
+        console.log('ftp.upload', r)
+
+        r = await ftp.syncToRemote('./_test_upload_client', '.', (p) => {
+            console.log('ftp.syncToRemote p', p.name, p.progress)
+        })
+        console.log('ftp.syncToRemote', r)
+
+    }
+    await core()
+        .catch((err) => {
+            console.log(err)
+        })
 
     r = await ftp.quit()
     console.log('ftp.quit', r)
@@ -56,8 +70,9 @@ test_up()
 //   groupPermissions: { read: true, write: true, exec: false },
 //   otherPermissions: { read: true, write: true, exec: false }
 // } 73
+// ftp.isFile false
+// ftp.isFolder false
 // ftp.upload p DECL_20210805055044.csv 75.71339448693362
-// drain
 // ftp.upload p DECL_20210805055044.csv 100
 // ftp.upload ok
 // ftp.syncToRemote { num: 0, files: [] }

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "w-ftp",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "main": "dist/w-ftp.umd.js",
   "dependencies": {
+    "dayjs": "^1.11.4",
     "debug": "^4.3.4",
     "ftp-response-parser": "^1.0.1",
+    "lodash": "^4.17.21",
     "once": "^1.4.0",
     "parse-listing": "^1.1.3",
     "stream-combiner": "^0.2.2",
     "unorm": "^1.6.0",
-    "lodash": "^4.17.21",
     "wsemi": "^1.6.69"
   },
   "devDependencies": {

package/src/WFtp.mjs

@@ -20,6 +20,7 @@ import fsTreeFolder from 'wsemi/src/fsTreeFolder.mjs'
 import fsIsFolder from 'wsemi/src/fsIsFolder.mjs'
 import fsIsFile from 'wsemi/src/fsIsFile.mjs'
 import fsCreateFolder from 'wsemi/src/fsCreateFolder.mjs'
+import ot from 'dayjs'
 import Jsftp from './jsftp.js'
 
 
@@ -60,7 +61,7 @@ import Jsftp from './jsftp.js'
  *     })
  *
  */
-async function ftpConn(opt = {}) {
+async function conn(opt = {}) {
     return null
 }
 
@@ -99,7 +100,7 @@ async function ftpConn(opt = {}) {
  *     })
  *
  */
-async function ftpLs(fdRemote = '.') {
+async function ls(fdRemote = '.') {
     return null
 }
 
@@ -135,7 +136,7 @@ async function ftpLs(fdRemote = '.') {
  *         console.log(err)
  *     })
  */
-async function ftpQuit() {
+async function quit() {
     return null
 }
 
@@ -173,7 +174,7 @@ async function ftpQuit() {
  *         console.log(err)
  *     })
  */
-async function ftpStateFile(fpRemote) {
+async function stateFile(fpRemote) {
     return null
 }
 
@@ -199,8 +200,8 @@ async function ftpStateFile(fpRemote) {
  *         password: st.up.password,
  *     })
  *
- *     r = await ftp.checkFile('./_test_upload_client/DECL_20210805055044.csv')
- *     console.log('ftp.checkFile', r)
+ *     r = await ftp.isFile('./_test_upload_client/DECL_20210805055044.csv')
+ *     console.log('ftp.isFile', r)
  *
  *     r = await ftp.quit()
  *     console.log('ftp.quit', r)
@@ -211,7 +212,45 @@ async function ftpStateFile(fpRemote) {
  *         console.log(err)
  *     })
  */
-async function ftpCheckFile(fpRemote) {
+async function isFile(fpRemote) {
+    return null
+}
+
+
+/**
+ * 確認伺服器指定資料夾是否存在
+ *
+ * @param {String} opt.fpRemote 輸入伺服器上指定資料夾字串
+ * @return {Promise} 回傳Promise，resolve回傳指定資料夾是否存在布林值，reject回傳錯誤訊息
+ * @example
+ * import WFtp from './src/WFtp.mjs'
+ *
+ * async function test() {
+ *     let r
+ *
+ *     let ftp = WFtp()
+ *     // console.log('ftp', ftp)
+ *
+ *     await ftp.conn({
+ *         hostname: st.up.hostname,
+ *         port: st.up.port,
+ *         username: st.up.username,
+ *         password: st.up.password,
+ *     })
+ *
+ *     r = await ftp.isFolder('./_test_upload_client')
+ *     console.log('ftp.isFolder', r)
+ *
+ *     r = await ftp.quit()
+ *     console.log('ftp.quit', r)
+ *
+ * }
+ * test()
+ *     .catch((err) => {
+ *         console.log(err)
+ *     })
+ */
+async function isFolder(fpRemote) {
     return null
 }
 
@@ -253,7 +292,7 @@ async function ftpCheckFile(fpRemote) {
  *         console.log(err)
  *     })
  */
-async function ftpDownload(fpRemote, fpLocal, cbProcess = null) {
+async function download(fpRemote, fpLocal, cbProcess = null) {
     return null
 }
 
@@ -295,7 +334,7 @@ async function ftpDownload(fpRemote, fpLocal, cbProcess = null) {
  *         console.log(err)
  *     })
  */
-async function ftpUpload(fpLocal, fpRemote, cbProcess) {
+async function upload(fpLocal, fpRemote, cbProcess) {
     return null
 }
 
@@ -337,7 +376,7 @@ async function ftpUpload(fpLocal, fpRemote, cbProcess) {
  *         console.log(err)
  *     })
  */
-async function ftpSyncToLocal(fdRemote, fdLocal, cbProcess) {
+async function syncToLocal(fdRemote, fdLocal, cbProcess) {
     return null
 }
 
@@ -379,7 +418,7 @@ async function ftpSyncToLocal(fdRemote, fdLocal, cbProcess) {
  *         console.log(err)
  *     })
  */
-async function ftpSyncToRemote(fdLocal, fdRemote, cbProcess) {
+async function syncToRemote(fdLocal, fdRemote, cbProcess) {
     return null
 }
 
@@ -387,11 +426,11 @@ async function ftpSyncToRemote(fdLocal, fdRemote, cbProcess) {
 /**
  * 操作FTP，包含連線、下載、資料夾內檔案同步下載、上傳、資料夾內檔案同步上傳等功能
  *
- * @returns {Object} 回傳FTP操作物件，包含conn、ls、stateFile、checkFile、download、syncToLocal、syncToRemote、upload、quit。
+ * @returns {Object} 回傳FTP操作物件，包含conn、ls、stateFile、isFile、download、syncToLocal、syncToRemote、upload、quit。
  * @example
  * import WFtp from './src/WFtp.mjs'
  *
- * async function test_up() {
+ * async function test_dw() {
  *     let r
  *
  *     let ftp = WFtp()
@@ -404,46 +443,73 @@ async function ftpSyncToRemote(fdLocal, fdRemote, cbProcess) {
  *         password: `{password}`,
  *     })
  *
- *     let fps = await ftp.ls('.')
- *     console.log('ftp.ls', fps[0], fps.length)
+ *     async function core() {
  *
- *     r = await ftp.upload('./_test_upload_client/DECL_20210805055044.csv', './DECL_20210805055044.csv', (p) => {
- *         console.log('ftp.upload p', p.name, p.progress)
- *     })
- *     console.log('ftp.upload', r)
+ *         let fps = await ftp.ls('.')
+ *         console.log('ftp.ls', fps[0], fps.length)
  *
- *     r = await ftp.syncToRemote('./_test_upload_client', '.', (p) => {
- *         console.log('ftp.syncToRemote p', p.name, p.progress)
- *     })
- *     console.log('ftp.syncToRemote', r)
+ *         r = await ftp.download('./DECL_20210805055044.csv', './_test_download_client/DECL_20210805055044.csv', (p) => {
+ *             console.log('ftp.download p', p.name, p.progress)
+ *         })
+ *         console.log('ftp.download', r)
+ *
+ *         r = await ftp.syncToLocal('.', './_test_download_client', (p) => {
+ *             console.log('ftp.syncToLocal p', p.name, p.progress)
+ *         })
+ *         console.log('ftp.syncToLocal', r)
+ *
+ *     }
+ *     await core()
+ *         .catch((err) => {
+ *             console.log(err)
+ *         })
  *
  *     r = await ftp.quit()
  *     console.log('ftp.quit', r)
  *
  * }
- * test_up()
+ * test_dw()
  *     .catch((err) => {
  *         console.log(err)
  *     })
  * // ftp.ls {
  * //   name: 'DECL_202108.csv',
  * //   type: 0,
- * //   time: 1658366760000,
+ * //   time: 1658302140000,
  * //   size: '218690',
  * //   owner: 'ftp',
  * //   group: 'ftp',
  * //   userPermissions: { read: true, write: true, exec: false },
  * //   groupPermissions: { read: true, write: true, exec: false },
  * //   otherPermissions: { read: true, write: true, exec: false }
- * // } 73
- * // ftp.upload p DECL_20210805055044.csv 75.71339448693362
- * // drain
- * // ftp.upload p DECL_20210805055044.csv 100
- * // ftp.upload ok
- * // ftp.syncToRemote { num: 0, files: [] }
+ * // } 74
+ * // ftp.download p DECL_20210805055044.csv 4.7320871554333515
+ * // ftp.download p DECL_20210805055044.csv 9.464174310866703
+ * // ftp.download p DECL_20210805055044.csv 14.196261466300053
+ * // ftp.download p DECL_20210805055044.csv 18.928348621733406
+ * // ftp.download p DECL_20210805055044.csv 23.660435777166754
+ * // ftp.download p DECL_20210805055044.csv 28.392522932600105
+ * // ftp.download p DECL_20210805055044.csv 33.12461008803346
+ * // ftp.download p DECL_20210805055044.csv 37.85669724346681
+ * // ftp.download p DECL_20210805055044.csv 42.58878439890016
+ * // ftp.download p DECL_20210805055044.csv 47.32087155433351
+ * // ftp.download p DECL_20210805055044.csv 52.05295870976686
+ * // ftp.download p DECL_20210805055044.csv 56.78504586520021
+ * // ftp.download p DECL_20210805055044.csv 61.517133020633565
+ * // ftp.download p DECL_20210805055044.csv 66.24922017606691
+ * // ftp.download p DECL_20210805055044.csv 70.98130733150026
+ * // ftp.download p DECL_20210805055044.csv 75.71339448693362
+ * // ftp.download p DECL_20210805055044.csv 80.44548164236697
+ * // ftp.download p DECL_20210805055044.csv 85.17756879780032
+ * // ftp.download p DECL_20210805055044.csv 89.90965595323367
+ * // ftp.download p DECL_20210805055044.csv 94.64174310866701
+ * // ftp.download p DECL_20210805055044.csv 99.37383026410038
+ * // ftp.download p DECL_20210805055044.csv 100
+ * // ftp.download ok
+ * // ftp.syncToLocal { num: 0, files: [] }
  * // ftp.quit { code: 221, text: '221 Goodbye.', isMark: false, isError: false }
  *
- * async function test_dw() {
+ * async function test_up() {
  *     let r
  *
  *     let ftp = WFtp()
@@ -456,76 +522,65 @@ async function ftpSyncToRemote(fdLocal, fdRemote, cbProcess) {
  *         password: `{password}`,
  *     })
  *
- *     let fps = await ftp.ls('.')
- *     console.log('ftp.ls', fps[0], fps.length)
+ *     async function core() {
  *
- *     r = await ftp.download('./DECL_20210805055044.csv', './_test_download_client/DECL_20210805055044.csv', (p) => {
- *         console.log('ftp.download p', p.name, p.progress)
- *     })
- *     console.log('ftp.download', r)
+ *         let fps = await ftp.ls('.')
+ *         console.log('ftp.ls', fps[0], fps.length)
  *
- *     r = await ftp.syncToLocal('.', './_test_download_client', (p) => {
- *         console.log('ftp.syncToLocal p', p.name, p.progress)
- *     })
- *     console.log('ftp.syncToLocal', r)
+ *         r = await ftp.upload('./_test_upload_client/DECL_20210805055044.csv', './DECL_20210805055044.csv', (p) => {
+ *             console.log('ftp.upload p', p.name, p.progress)
+ *         })
+ *         console.log('ftp.upload', r)
+ *
+ *         r = await ftp.syncToRemote('./_test_upload_client', '.', (p) => {
+ *             console.log('ftp.syncToRemote p', p.name, p.progress)
+ *         })
+ *         console.log('ftp.syncToRemote', r)
+ *
+ *     }
+ *     await core()
+ *         .catch((err) => {
+ *             console.log(err)
+ *         })
  *
  *     r = await ftp.quit()
  *     console.log('ftp.quit', r)
  *
  * }
- * test_dw()
+ * test_up()
  *     .catch((err) => {
  *         console.log(err)
  *     })
  * // ftp.ls {
  * //   name: 'DECL_202108.csv',
  * //   type: 0,
- * //   time: 1658302140000,
+ * //   time: 1658366760000,
  * //   size: '218690',
  * //   owner: 'ftp',
  * //   group: 'ftp',
  * //   userPermissions: { read: true, write: true, exec: false },
  * //   groupPermissions: { read: true, write: true, exec: false },
  * //   otherPermissions: { read: true, write: true, exec: false }
- * // } 74
- * // ftp.download p DECL_20210805055044.csv 4.7320871554333515
- * // ftp.download p DECL_20210805055044.csv 9.464174310866703
- * // ftp.download p DECL_20210805055044.csv 14.196261466300053
- * // ftp.download p DECL_20210805055044.csv 18.928348621733406
- * // ftp.download p DECL_20210805055044.csv 23.660435777166754
- * // ftp.download p DECL_20210805055044.csv 28.392522932600105
- * // ftp.download p DECL_20210805055044.csv 33.12461008803346
- * // ftp.download p DECL_20210805055044.csv 37.85669724346681
- * // ftp.download p DECL_20210805055044.csv 42.58878439890016
- * // ftp.download p DECL_20210805055044.csv 47.32087155433351
- * // ftp.download p DECL_20210805055044.csv 52.05295870976686
- * // ftp.download p DECL_20210805055044.csv 56.78504586520021
- * // ftp.download p DECL_20210805055044.csv 61.517133020633565
- * // ftp.download p DECL_20210805055044.csv 66.24922017606691
- * // ftp.download p DECL_20210805055044.csv 70.98130733150026
- * // ftp.download p DECL_20210805055044.csv 75.71339448693362
- * // ftp.download p DECL_20210805055044.csv 80.44548164236697
- * // ftp.download p DECL_20210805055044.csv 85.17756879780032
- * // ftp.download p DECL_20210805055044.csv 89.90965595323367
- * // ftp.download p DECL_20210805055044.csv 94.64174310866701
- * // ftp.download p DECL_20210805055044.csv 99.37383026410038
- * // ftp.download p DECL_20210805055044.csv 100
- * // ftp.download ok
- * // ftp.syncToLocal { num: 0, files: [] }
+ * // } 73
+ * // ftp.upload p DECL_20210805055044.csv 75.71339448693362
+ * // ftp.upload p DECL_20210805055044.csv 100
+ * // ftp.upload ok
+ * // ftp.syncToRemote { num: 0, files: [] }
  * // ftp.quit { code: 221, text: '221 Goodbye.', isMark: false, isError: false }
  *
  */
 function WFtp() {
     let doc = {
-        doc_ftpConn: ftpConn,
-        doc_ftpLs: ftpLs,
-        doc_ftpQuit: ftpQuit,
-        doc_ftpStateFile: ftpStateFile,
-        doc_ftpCheckFile: ftpCheckFile,
-        doc_ftpDownload: ftpDownload,
-        doc_ftpUpload: ftpUpload,
-        doc_ftpSyncToLocal: ftpSyncToLocal,
-        doc_ftpSyncToRemote: ftpSyncToRemote,
+        doc_conn: conn,
+        doc_ls: ls,
+        doc_quit: quit,
+        doc_stateFile: stateFile,
+        doc_isFile: isFile,
+        doc_isFolder: isFolder,
+        doc_download: download,
+        doc_upload: upload,
+        doc_syncToLocal: syncToLocal,
+        doc_syncToRemote: syncToRemote,
     }
 
     function WFtpCore() {
@@ -600,6 +655,12 @@ function WFtp() {
                     pm.reject(err)
                 }
                 else {
+                    res = map(res, (v) => {
+                        let d = ot(v.time) //jsfpt解析時間係基於ls, 其檔案變更時間精度只至分而沒有秒, 故無法提供精確的檔案變更時間
+                        v.ctime = d.format('YYYY-MM-DDTHH:mm:ssZ') //添加UTC時間
+                        v.isFolder = ftpIsFolderCore(v)
+                        return v
+                    })
                     pm.resolve(res)
                 }
             })
@@ -652,13 +713,56 @@ function WFtp() {
         }
 
 
-        async function ftpCheckFile(fpRemote) {
+        function ftpIsFolderCore(file) {
+
+            //check
+            if (!iseobj(file)) {
+                return false
+            }
+
+            //type
+            let type = get(file, 'type', -1)
+
+            //b
+            let b = type === 1
+
+            return b
+        }
+
+
+        function ftpIsFileCore(file) {
+
+            //check
+            if (!iseobj(file)) {
+                return false
+            }
+
+            //type
+            let type = get(file, 'type', -1)
+
+            //b
+            let b = type === 0
+
+            return b
+        }
+
+
+        async function ftpIsFolder(fpRemote) {
 
             //ftpStateFile
             let file = await ftpStateFile(fpRemote)
 
-            //b
-            let b = iseobj(file)
+            //ftpIsFolderCore
+            let b = ftpIsFolderCore(file)
+
+            return b
+        }
+
+
+        async function ftpIsFile(fpRemote) {
+
+            //ftpIsFileCore
+            let b = await ftpIsFileCore(fpRemote)
 
             return b
         }
@@ -699,6 +803,22 @@ function WFtp() {
             let file = await ftpStateFile(fpRemote)
             // console.log('file', file)
 
+            //ftpIsFileCore
+            let b = await ftpIsFileCore(file)
+            // console.log('b', b)
+
+            //check
+            if (!b) {
+                pm.reject(`fpRemote[${fpRemote}] is not a file`)
+                return pm
+            }
+
+            //check
+            if (!iseobj(file)) {
+                pm.reject(`fpRemote[${fpRemote}] does not have information`)
+                return pm
+            }
+
             //fileSize
             let fileSize = get(file, 'size')
 
@@ -862,11 +982,9 @@ function WFtp() {
 
             //ftpLs
             let fsRemote = await ftpLs(fdRemote)
-            // fsRemote = map(fsRemote, (v) => {
-            //     let d = dayjs(v.time)
-            //     v.stat = d.format('YYYY-MM-DDTHH:mm:ss')
-            //     return v
-            // })
+            fsRemote = filter(fsRemote, (v) => {
+                return !v.isFolder
+            })
             // console.log('fsRemote', fsRemote)
 
             //check fdLocal
@@ -1039,7 +1157,8 @@ function WFtp() {
             conn: ftpConn,
             ls: ftpLs,
             stateFile: ftpStateFile,
-            checkFile: ftpCheckFile,
+            isFile: ftpIsFile,
+            isFolder: ftpIsFolder,
             download: ftpDownload,
             syncToLocal: ftpSyncToLocal,
             syncToRemote: ftpSyncToRemote,