wsemi 1.9.0 → 1.9.2

package/src/isblob.mjs

@@ -1,22 +1,41 @@
-/**
- * 前端判斷是否為Blob，NodeJS沒有Blob
- *
- * Unit Test: {@link https://github.com/yuda-lyu/wsemi/blob/master/test/isblob.test.mjs Github}
- * @memberOf wsemi
- * @param {*} v 輸入任意資料
- * @returns {Boolean} 回傳判斷布林值
- * @example
- * need test in browser
- *
- * let bb = new Blob([new Uint8Array([66, 97, 115])])
- * console.log(isblob(bb))
- * // => true
- *
- */
-function isblob(v) {
-    let c = Object.prototype.toString.call(v)
-    return c === '[object Blob]'
-}
-
-
-export default isblob
+/**
+ * 判斷是否為Blob或其子型別(File)
+ *
+ * File繼承自Blob，具備Blob全部方法，由input type=file取得者皆為File，故一併視為Blob；若須區分File請用isfile。瀏覽器與NodeJS(18以上)皆有Blob，NodeJS 20以上有File
+ *
+ * Unit Test: {@link https://github.com/yuda-lyu/wsemi/blob/master/test/isblob.test.mjs Github}
+ * @memberOf wsemi
+ * @param {*} v 輸入任意資料
+ * @returns {Boolean} 回傳判斷布林值
+ * @example
+ *
+ * let bb = new Blob([new Uint8Array([66, 97, 115])])
+ * console.log(isblob(bb))
+ * // => true
+ *
+ * let fl = new File([new Uint8Array([66, 97, 115])], 'a.txt')
+ * console.log(isblob(fl))
+ * // => true
+ *
+ */
+function isblob(v) {
+
+    //以標籤判定, 跨iframe等不同realm時instanceof會失效而標籤仍有效; File之標籤為[object File]而非[object Blob], 須一併列入
+    let c = Object.prototype.toString.call(v)
+    if (c === '[object Blob]' || c === '[object File]') {
+        return true
+    }
+
+    //其他Blob子型別以instanceof判定, 無Blob之環境須先確認其存在
+    try {
+        if (typeof Blob !== 'undefined' && v instanceof Blob) {
+            return true
+        }
+    }
+    catch (err) {}
+
+    return false
+}
+
+
+export default isblob

package/src/isfile.mjs

@@ -1,5 +1,5 @@
 /**
- * 前端判斷是否為File，NodeJS沒有File
+ * 判斷是否為File，瀏覽器與NodeJS(20以上)皆有File；File為Blob之子型別，isblob對File亦回傳true，須區分兩者時用本函數
  *
  * Unit Test: {@link https://github.com/yuda-lyu/wsemi/blob/master/test/isfile.test.mjs Github}
  * @memberOf wsemi

package/test/_getDiff2Html.test.mjs

@@ -0,0 +1,56 @@
+import assert from 'assert'
+import getDiff2Html from '../src/_getDiff2Html.mjs'
+
+
+describe(`_getDiff2Html`, function() {
+
+    it(`should return the native ESM namespace having html in nodejs`, function() {
+        let r = getDiff2Html()
+        assert.strict.deepStrictEqual(typeof r.html, 'function')
+    })
+
+    it(`should accept a bundler interop namespace, a null prototype object without Symbol.toStringTag`, function() {
+        //UMD打包後之namespace標籤為[object Object]而非[object Module], 舊判定據此誤判為未載入而拋錯
+        let mod = Object.create(null)
+        mod.html = () => 'x'
+        assert.strict.deepStrictEqual(Object.prototype.toString.call(mod), '[object Object]')
+        assert.strict.deepStrictEqual(getDiff2Html(mod) === mod, true)
+    })
+
+    it(`should accept html hung on default`, function() {
+        let mod = { default: { html: () => 'x' } }
+        assert.strict.deepStrictEqual(getDiff2Html(mod) === mod.default, true)
+    })
+
+    it(`should fall back to the global Diff2Html and its default`, function() {
+        let orig = globalThis.Diff2Html
+        try {
+            let g1 = { html: () => 'x' }
+            globalThis.Diff2Html = g1
+            assert.strict.deepStrictEqual(getDiff2Html({}) === g1, true)
+            let g2 = { default: { html: () => 'x' } }
+            globalThis.Diff2Html = g2
+            assert.strict.deepStrictEqual(getDiff2Html({}) === g2.default, true)
+        }
+        finally {
+            if (orig === undefined) {
+                delete globalThis.Diff2Html
+            }
+            else {
+                globalThis.Diff2Html = orig
+            }
+        }
+    })
+
+    it(`should throw when neither the import nor the global provides html`, function() {
+        let orig = console.log
+        console.log = () => {}
+        try {
+            assert.throws(() => getDiff2Html({}), /invalid Diff2Html/)
+        }
+        finally {
+            console.log = orig
+        }
+    })
+
+})

package/test/blob2ab.test.mjs

@@ -20,4 +20,10 @@ describe('blob2ab', function() {
         assert.strict.deepStrictEqual(r, { mode: 'reject', msg: 'no window' })
     })
 
+    it('should accept a File as input, passing the input check like a Blob', async function() {
+        //input type=file取得者為File; 通過輸入檢查後於nodejs得no window, 不得為invalid bb
+        let r = await getRes(() => blob2ab(new File([new Uint8Array([1, 2, 3])], 'a.txt')))
+        assert.strict.deepStrictEqual(r, { mode: 'reject', msg: 'no window' })
+    })
+
 })