w-zip 1.0.21 → 1.0.23

package/docs/m7z.mjs.html

@@ -60,13 +60,13 @@ import checkTarget from './checkTarget.mjs'
  * @example
  * import wz from 'w-zip'
  *
- * let fpUnzip = './testData/output7z'
+ * let fpUnzip = './test/output7z'
  * let fpUnzipExtract = fpUnzip + '/extract'
  *
- * let fpSrc1 = './testData/input/file1(中文).txt'
+ * let fpSrc1 = './test/input/file1(中文).txt'
  * let fpZip1 = fpUnzip + '/test1.7z'
  *
- * let fpSrc2 = './testData/input/folder1'
+ * let fpSrc2 = './test/input/folder1'
  * let fpZip2 = fpUnzip + '/test2.7z'
  * let fpZip2PW = fpUnzip + '/test2PW.7z'
  * let pw = 'abc'
@@ -166,7 +166,7 @@ function m7z() {
     }
 
 
-    async function zip(fpSrc, fpTar, level = 9, pw = '') {
+    async function zip(fpSrc, fpTar, level = 1, pw = '') { //7z的-mx1為最快速壓縮(mx0為不壓縮)
         let arg = [
             'a',
             fpTar,
@@ -188,8 +188,8 @@ function m7z() {
      * @param {String} fpSrc 輸入壓縮來源檔案位置字串
      * @param {String} fpTar 輸入壓縮目標檔案位置字串
      * @param {Object} [opt={}] 輸入設定物件，預設{}
-     * @param {Integer} [opt.level] 輸入壓縮程度整數，範圍為0至9，0為不壓縮而9為最高壓縮，預設9
-     * @param {String} [opt.pw] 輸入壓縮密碼字串，預設''
+     * @param {Integer} [opt.level=1] 輸入壓縮程度整數，範圍為0至9，0為不壓縮而9為最高壓縮，預設1為最快速壓縮
+     * @param {String} [opt.pw=''] 輸入壓縮密碼字串，預設''
      * @returns {Promise} 回傳Promise，resolve為成功資訊，reject為失敗資訊
      */
     async function zipFile(fpSrc, fpTar, opt = {}) {
@@ -208,7 +208,7 @@ function m7z() {
         }
 
         //default
-        let level = get(opt, 'level', 9)
+        let level = get(opt, 'level', 1)
         let pw = get(opt, 'pw', '')
 
         //r
@@ -237,7 +237,7 @@ function m7z() {
      * @param {String} fpSrc 輸入壓縮來源資料夾位置字串
      * @param {String} fpTar 輸入壓縮目標資料夾位置字串
      * @param {Object} [opt={}] 輸入設定物件，預設{}
-     * @param {Integer} [opt.level] 輸入壓縮程度整數，範圍為0至9，0為不壓縮而9為最高壓縮，預設9
+     * @param {Integer} [opt.level=1] 輸入壓縮程度整數，範圍為0至9，0為不壓縮而9為最高壓縮，預設1為最快速壓縮
      * @param {String} [opt.pw] 輸入壓縮密碼字串，預設''
      * @returns {Promise} 回傳Promise，resolve為成功資訊，reject為失敗資訊
      */
@@ -257,7 +257,7 @@ function m7z() {
         }
 
         //default
-        let level = get(opt, 'level', 9)
+        let level = get(opt, 'level', 1)
         let pw = get(opt, 'pw', '')
 
         //r
@@ -321,7 +321,7 @@ function m7z() {
         let error = null
         let r = await execProcess(prog, arg)
             .catch((err) => {
-                error = err
+                error = err.toString()
             })
 
         //check
@@ -360,7 +360,7 @@ export default m7z()
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.2</a> on Sun Jul 13 2025 10:12:56 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 4.0.5</a> on Sat May 30 2026 20:38:46 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/mZip.html

@@ -80,7 +80,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="mZip.mjs.html">mZip.mjs</a>, <a href="mZip.mjs.html#line93">line 93</a>
+        <a href="mZip.mjs.html">mZip.mjs</a>, <a href="mZip.mjs.html#line90">line 90</a>
     </li></ul></dd>
     
 
@@ -127,7 +127,7 @@
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>import wz from 'w-zip'
    //zipFile
    console.log('zipFile before')
    console.log('zipFile', await wz.mZip.zipFile(fpSrc1, fpZip1))
    console.log('zipFile after')
    //zipFolder
    console.log('zipFolder before')
    console.log('zipFolder', await wz.mZip.zipFolder(fpSrc2, fpZip2))
    console.log('zipFolder after')
    //zipFolder with password
    console.log('zipFolder with password before')
    console.log('zipFolder with password', await wz.mZip.zipFolder(fpSrc2, fpZip2PW, { pw }))
    console.log('zipFolder with password after')
    //unzip
    console.log('unzip1 before')
    console.log('unzip1', await wz.mZip.unzip(fpZip1, fpUnzipExtract + '/test1'))
    console.log('unzip1 after')
    //unzip
    console.log('unzip2 before')
    console.log('unzip2', await wz.mZip.unzip(fpZip2, fpUnzipExtract + '/test2'))
    console.log('unzip2 after')
    //unzip with password
    console.log('unzip2 with password before')
    console.log('unzip2 with password', await wz.mZip.unzip(fpZip2PW, fpUnzipExtract + '/test2PW', { pw }))
    console.log('unzip2 with password after')
    .catch((err) => {
        console.log(err)
    })
+    <pre class="prettyprint"><code>import wz from 'w-zip'
    //zipFile
    console.log('zipFile before')
    console.log('zipFile', await wz.mZip.zipFile(fpSrc1, fpZip1))
    console.log('zipFile after')
    //zipFolder
    console.log('zipFolder before')
    console.log('zipFolder', await wz.mZip.zipFolder(fpSrc2, fpZip2))
    console.log('zipFolder after')
    //zipFolder with password
    console.log('zipFolder with password before')
    console.log('zipFolder with password', await wz.mZip.zipFolder(fpSrc2, fpZip2PW, { pw }))
    console.log('zipFolder with password after')
    //unzip
    console.log('unzip1 before')
    console.log('unzip1', await wz.mZip.unzip(fpZip1, fpUnzipExtract + '/test1'))
    console.log('unzip1 after')
    //unzip
    console.log('unzip2 before')
    console.log('unzip2', await wz.mZip.unzip(fpZip2, fpUnzipExtract + '/test2'))
    console.log('unzip2 after')
    //unzip with password
    console.log('unzip2 with password before')
    console.log('unzip2 with password', await wz.mZip.unzip(fpZip2PW, fpUnzipExtract + '/test2PW', { pw }))
    console.log('unzip2 with password after')
    .catch((err) => {
        console.log(err)
    })
 
 
 
@@ -214,7 +214,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="mZip.mjs.html">mZip.mjs</a>, <a href="mZip.mjs.html#line278">line 278</a>
+        <a href="mZip.mjs.html">mZip.mjs</a>, <a href="mZip.mjs.html#line256">line 256</a>
     </li></ul></dd>
     
 
@@ -534,7 +534,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="mZip.mjs.html">mZip.mjs</a>, <a href="mZip.mjs.html#line107">line 107</a>
+        <a href="mZip.mjs.html">mZip.mjs</a>, <a href="mZip.mjs.html#line104">line 104</a>
     </li></ul></dd>
     
 
@@ -733,6 +733,8 @@
         
 
         
+        <th>Default</th>
+        
 
         <th class="last">Description</th>
     </tr>
@@ -769,6 +771,12 @@
             
 
             
+                <td class="default">
+                
+                    <code>9</code>
+                
+                </td>
+            
 
             <td class="description last"><p>輸入壓縮程度整數，範圍為0至9，0為不壓縮而9為最高壓縮，預設9</p></td>
         </tr>
@@ -803,6 +811,10 @@
             
 
             
+                <td class="default">
+                
+                </td>
+            
 
             <td class="description last"><p>輸入壓縮密碼字串，預設''</p></td>
         </tr>
@@ -880,7 +892,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="mZip.mjs.html">mZip.mjs</a>, <a href="mZip.mjs.html#line192">line 192</a>
+        <a href="mZip.mjs.html">mZip.mjs</a>, <a href="mZip.mjs.html#line167">line 167</a>
     </li></ul></dd>
     
 
@@ -1085,7 +1097,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.2</a> on Sun Jul 13 2025 10:12:56 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 4.0.5</a> on Sat May 30 2026 20:38:46 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/mZip.mjs.html

@@ -47,18 +47,15 @@
         <article>
             <pre class="prettyprint source linenums"><code>import path from 'path'
 import fs from 'fs'
-import archiver from 'archiver'
-import archiverEnc from 'archiver-zip-encrypted'
-import unzipper from 'unzipper'
-import get from 'lodash-es/get.js'
-import genPm from 'wsemi/src/genPm.mjs'
-import pmMap from 'wsemi/src/pmMap.mjs'
+import { configure, ZipWriter, ZipReader, Uint8ArrayReader, Uint8ArrayWriter } from '@zip.js/zip.js'
+import get from 'lodash-es/get.js'
+import fsTreeFolder from 'wsemi/src/fsTreeFolder.mjs'
 import getFileName from 'wsemi/src/getFileName.mjs'
 import checkTarget from './checkTarget.mjs'
 
 
-//registerFormat
-archiver.registerFormat('zip-encrypted', archiverEnc)
+//configure
+configure({ useWebWorkers: false }) //關閉web worker改用主執行緒壓縮, 確保nodejs下無殘留worker導致process無法結束
 
 
 /**
@@ -69,13 +66,13 @@ archiver.registerFormat('zip-encrypted', archiverEnc)
  * @example
  * import wz from 'w-zip'
  *
- * let fpUnzip = './testData/outputZip'
+ * let fpUnzip = './test/outputZip'
  * let fpUnzipExtract = fpUnzip + '/extract'
  *
- * let fpSrc1 = './testData/input/file1(中文).txt'
+ * let fpSrc1 = './test/input/file1(中文).txt'
  * let fpZip1 = fpUnzip + '/test1.zip'
  *
- * let fpSrc2 = './testData/input/folder1'
+ * let fpSrc2 = './test/input/folder1'
  * let fpZip2 = fpUnzip + '/test2.zip'
  * let fpZip2PW = fpUnzip + '/test2PW.zip'
  * let pw = 'abc'
@@ -147,7 +144,7 @@ function mZip() {
      * @param {String} fpSrc 輸入壓縮來源檔案位置字串
      * @param {String} fpTar 輸入壓縮目標檔案位置字串
      * @param {Object} [opt={}] 輸入設定物件，預設{}
-     * @param {Integer} [opt.level] 輸入壓縮程度整數，範圍為0至9，0為不壓縮而9為最高壓縮，預設9
+     * @param {Integer} [opt.level=9] 輸入壓縮程度整數，範圍為0至9，0為不壓縮而9為最高壓縮，預設9
      * @param {String} [opt.pw] 輸入壓縮密碼字串，預設''
      * @returns {Promise} 回傳Promise，resolve為成功資訊，reject為失敗資訊
      */
@@ -172,54 +169,32 @@ function mZip() {
 
         try {
 
-            //pm
-            let pm = genPm()
-
             //check
             if (!fs.existsSync(path.dirname(fpTar))) {
                 fs.mkdirSync(path.dirname(fpTar), { recursive: true })
             }
 
-            //archiver
-            let output = fs.createWriteStream(fpTar)
-            let archive
-            if (pw === '') {
-                archive = archiver('zip', {
-                    zlib: { level },
-                })
-            }
-            else {
-                archive = archiver('zip-encrypted', {
-                    zlib: { level },
-                    encryptionMethod: 'zip20', //只能用zip20, 因unzipper目前不支援aes256
-                    password: pw,
-                })
+            //zipOpt
+            let zipOpt = { level }
+            if (pw !== '') {
+                zipOpt.password = pw
+                zipOpt.zipCrypto = true //使用ZipCrypto(即zip20)加密維持與舊版相同相容性, 若需更強加密可改為encryptionStrength: 3(AES-256)
             }
 
-            output.on('close', function() {
-                //console.log(archive.pointer() + ' total bytes')
-
-                //resolve
-                pm.resolve('done: ' + fpTar)
+            //zipWriter
+            let zipWriter = new ZipWriter(new Uint8ArrayWriter(), zipOpt)
 
-            })
-            archive.on('warning', function(warn) {
-                //console.log('warning', warn)
-            })
-            archive.on('error', function(err) {
-                Promise.reject(err)
-            })
+            //add
+            let b = fs.readFileSync(fpSrc)
+            await zipWriter.add(path.basename(fpSrc), new Uint8ArrayReader(b))
 
-            //pipe
-            archive.pipe(output)
+            //close
+            let u8 = await zipWriter.close()
 
-            //file
-            archive.file(fpSrc, { name: path.basename(fpSrc) })
+            //writeFileSync
+            fs.writeFileSync(fpTar, u8)
 
-            //finalize
-            archive.finalize()
-
-            return pm
+            return Promise.resolve('done: ' + fpTar)
         }
         catch (err) {
             return Promise.reject(err)
@@ -257,54 +232,57 @@ function mZip() {
 
         try {
 
-            //pm
-            let pm = genPm()
-
             //check
             if (!fs.existsSync(path.dirname(fpTar))) {
                 fs.mkdirSync(path.dirname(fpTar), { recursive: true })
             }
 
-            //archiver
-            let output = fs.createWriteStream(fpTar)
-            let archive
-            if (pw === '') {
-                archive = archiver('zip', {
-                    zlib: { level },
-                })
-            }
-            else {
-                archive = archiver('zip-encrypted', {
-                    zlib: { level },
-                    encryptionMethod: 'zip20', //只能用zip20, 因unzipper目前不支援aes256
-                    password: pw,
-                })
+            //zipOpt
+            let zipOpt = { level }
+            if (pw !== '') {
+                zipOpt.password = pw
+                zipOpt.zipCrypto = true //使用ZipCrypto(即zip20)加密維持與舊版相同相容性, 若需更強加密可改為encryptionStrength: 3(AES-256)
             }
 
-            output.on('close', function() {
-                //console.log(archive.pointer() + ' total bytes')
+            //zipWriter
+            let zipWriter = new ZipWriter(new Uint8ArrayWriter(), zipOpt)
 
-                //resolve
-                pm.resolve('done: ' + fpTar)
+            //bn, 以來源資料夾名稱為zip內根目錄(同archiver.directory(fpSrc, basename)行為)
+            let bn = path.basename(fpSrc)
 
-            })
-            archive.on('warning', function(warn) {
-                //console.log('warning', warn)
-            })
-            archive.on('error', function(err) {
-                Promise.reject(err)
-            })
+            //items, 遞迴列舉資料夾下全部檔案與子資料夾
+            let items = fsTreeFolder(fpSrc, null)
 
-            //pipe
-            archive.pipe(output)
+            //add
+            for (let item of items) {
 
-            //directory
-            archive.directory(fpSrc, path.basename(fpSrc))
+                //name, zip內相對路徑統一用'/'
+                let rel = path.relative(fpSrc, item.path)
+                let name = path.join(bn, rel).replaceAll('\\', '/')
+
+                if (item.isFolder) {
+
+                    //directory, 保留空資料夾結構
+                    await zipWriter.add(name, undefined, { directory: true })
+
+                }
+                else {
 
-            //finalize
-            archive.finalize()
+                    //file
+                    let b = fs.readFileSync(item.path)
+                    await zipWriter.add(name, new Uint8ArrayReader(b))
 
-            return pm
+                }
+
+            }
+
+            //close
+            let u8 = await zipWriter.close()
+
+            //writeFileSync
+            fs.writeFileSync(fpTar, u8)
+
+            return Promise.resolve('done: ' + fpTar)
         }
         catch (err) {
             return Promise.reject(err)
@@ -340,67 +318,54 @@ function mZip() {
         //default
         let pw = get(opt, 'pw', '')
 
-        //extract
-        async function extract(fpSrc, fpTar, password) {
-
-            //mkdir
-            async function mkdir(fd) {
-                try {
-
-                    //check
-                    if (!fs.existsSync(fd)) {
-                        fs.mkdirSync(fd, { recursive: true })
-                    }
+        try {
 
-                }
-                catch (err) {
-                    return Promise.reject(err)
-                }
-                return 'done'
+            //readerOpt
+            let readerOpt = {}
+            if (pw !== '') {
+                readerOpt.password = pw
             }
 
-            //extractFile
-            async function extractFile(file, fn, password = '') {
-                try {
+            //zipReader
+            let b = fs.readFileSync(fpSrc)
+            let zipReader = new ZipReader(new Uint8ArrayReader(b), readerOpt)
 
-                    //check
-                    if (!fs.existsSync(path.dirname(fn))) {
-                        fs.mkdirSync(path.dirname(fn), { recursive: true })
-                    }
+            //entries
+            let entries = await zipReader.getEntries()
 
-                    //buffer
-                    let b = await file.buffer(password)
+            //extract
+            for (let entry of entries) {
 
-                    //writeFileSync
-                    fs.writeFileSync(fn, b)
+                //p, 解壓目標位置
+                let p = path.join(fpTar, entry.filename)
 
-                }
-                catch (err) {
-                    return Promise.reject(err)
-                }
-                return 'done'
-            }
+                if (entry.directory) {
 
-            //directory
-            let directory = await unzipper.Open.file(fpSrc)
+                    //mkdir
+                    if (!fs.existsSync(p)) {
+                        fs.mkdirSync(p, { recursive: true })
+                    }
 
-            //pmMap
-            return pmMap(directory.files, async (file) => {
-                let p = path.join(fpTar, file.path)
-                if (file.type === 'File') {
-                    return extractFile(file, p, password)
                 }
                 else {
-                    return mkdir(p)
-                }
-            })
 
-        }
+                    //mkdir, 先建立上層資料夾
+                    if (!fs.existsSync(path.dirname(p))) {
+                        fs.mkdirSync(path.dirname(p), { recursive: true })
+                    }
 
-        try {
+                    //getData
+                    let u8 = await entry.getData(new Uint8ArrayWriter())
 
-            //extract
-            await extract(fpSrc, fpTar, pw)
+                    //writeFileSync
+                    fs.writeFileSync(p, u8)
+
+                }
+
+            }
+
+            //close
+            await zipReader.close()
 
             return Promise.resolve('done: ' + getFileName(fpTar))
         }
@@ -433,7 +398,7 @@ export default mZip()
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.2</a> on Sun Jul 13 2025 10:12:56 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 4.0.5</a> on Sat May 30 2026 20:38:46 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/g-7z.mjs

@@ -1,13 +1,13 @@
 import wz from './src/WZip.mjs'
 import w from 'wsemi'
 
-let fpUnzip = './testData/output7z'
+let fpUnzip = './test/output7z'
 let fpUnzipExtract = fpUnzip + '/extract'
 
-let fpSrc1 = './testData/input/file1(中文).txt'
+let fpSrc1 = './test/input/file1(中文).txt'
 let fpZip1 = fpUnzip + '/test1.7z'
 
-let fpSrc2 = './testData/input/folder1'
+let fpSrc2 = './test/input/folder1'
 let fpZip2 = fpUnzip + '/test2.7z'
 let fpZip2PW = fpUnzip + '/test2PW.7z'
 let pw = 'abc'

package/g-zip.mjs

@@ -1,13 +1,13 @@
 import wz from './src/WZip.mjs'
 import w from 'wsemi'
 
-let fpUnzip = './testData/outputZip'
+let fpUnzip = './test/outputZip'
 let fpUnzipExtract = fpUnzip + '/extract'
 
-let fpSrc1 = './testData/input/file1(中文).txt'
+let fpSrc1 = './test/input/file1(中文).txt'
 let fpZip1 = fpUnzip + '/test1.zip'
 
-let fpSrc2 = './testData/input/folder1'
+let fpSrc2 = './test/input/folder1'
 let fpZip2 = fpUnzip + '/test2.zip'
 let fpZip2PW = fpUnzip + '/test2PW.zip'
 let pw = 'abc'

package/package.json

@@ -1,16 +1,14 @@
 {
   "name": "w-zip",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "main": "dist/w-zip.umd.js",
   "dependencies": {
-    "archiver": "^7.0.1",
-    "archiver-zip-encrypted": "^2.0.0",
-    "unzipper": "^0.12.3",
-    "lodash-es": "^4.17.21",
-    "wsemi": "^1.8.14"
+    "@zip.js/zip.js": "^2.8.26",
+    "lodash-es": "^4.18.1",
+    "wsemi": "^1.8.54"
   },
   "devDependencies": {
-    "w-package-tools": "^1.1.2"
+    "w-package-tools": "^1.1.7"
   },
   "scripts": {
     "test": "mocha --parallel --timeout 60000",

package/script.txt

@@ -14,7 +14,4 @@ npm run deploy
 
 #npm test
 
-#node g-zip.mjs
-
 #npm publish
-