Merge branch 'release/v1.3' into pr-permission-check-and-better-page

Author: cyfung1031

example/gm_add_element.js

@@ -22,9 +22,36 @@
  * 2. 元素标签名
  * 3. 属性对象
  */
-const el = GM_addElement(document.querySelector('.BorderGrid-cell'), "img", {
-    src: "https://bbs.tampermonkey.net.cn/uc_server/avatar.php?uid=4&size=small&ts=1"
+
+// ------------- 基础用法 ----------------
+
+const el = GM_addElement(document.querySelector(".BorderGrid-cell"), "img", {
+  src: "https://bbs.tampermonkey.net.cn/uc_server/avatar.php?uid=4&size=small&ts=1",
 });
 
 // 打印创建出来的 DOM 元素
 console.log(el);
+
+// ------------- 基础用法 - textContent ----------------
+
+const span3 = GM_addElement("span", {
+  textContent: "Hello",
+});
+
+console.log(`span text: ${span3.textContent}`);
+
+// ------------- 基础用法 - onload & onerror ----------------
+
+new Promise((resolve, reject) => {
+  img = GM_addElement(document.body, "img", {
+    src: "https://www.tampermonkey.net/favicon.ico",
+    onload: resolve,
+    onerror: reject,
+  });
+})
+  .then(() => {
+    console.log("img insert ok");
+  })
+  .catch(() => {
+    console.log("img insert failed");
+  });

example/gm_download.js

@@ -18,6 +18,9 @@
  * - 自定义 header
  * - 进度回调 / 完成回调
  */
+
+// 1. 下载网络资源
+
 GM_download({
     url: "https://scriptcat.org/api/v2/open/crx-download/ndcooeababalnlpkfedmmbbbgkljhpjf",
     name: "scriptcat.crx",
@@ -35,3 +38,23 @@ GM_download({
         console.log("load", data);
     },
 });
+
+// 2. 下载 Blob 资源
+// 参考： https://github.com/Tampermonkey/tampermonkey/issues/2591
+
+const pngData = new Uint8Array([
+    0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a, 0x00, 0x00, 0x00, 0x0d,
+    0x49, 0x48, 0x44, 0x52, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x01,
+    0x08, 0x06, 0x00, 0x00, 0x00, 0x1f, 0x15, 0xc4, 0x89, 0x00, 0x00, 0x00,
+    0x0a, 0x49, 0x44, 0x41, 0x54, 0x08, 0xd7, 0x63, 0xf8, 0xcf, 0xc0, 0x00,
+    0x00, 0x03, 0x01, 0x01, 0x00, 0xae, 0xb4, 0xfa, 0x77, 0x00, 0x00, 0x00,
+    0x00, 0x49, 0x45, 0x4e, 0x44, 0xae, 0x42, 0x60, 0x82
+]);
+
+const testImageUrl = URL.createObjectURL(new Blob([pngData], { type: 'image/png' }));
+
+GM_download({
+    url: testImageUrl,
+    name: 'test/test.png', // 储存在 test 资料夹内
+    conflictAction: 'overwrite', // 每次都使用固定的档案名
+});

example/tests/gm_api_test.js

@@ -1,7 +1,7 @@
 // ==UserScript==
 // @name         GM API 完整测试
 // @namespace    https://docs.scriptcat.org/
-// @version      1.0.0
+// @version      1.1.0
 // @description  全面测试ScriptCat的所有GM API功能
 // @author       ScriptCat
 // @match        https://content-security-policy.com/
@@ -234,7 +234,7 @@
   });
 
   // ============ GM_addElement 测试 ============
-  test("GM_addElement - 创建元素", () => {
+  await testAsync("GM_addElement - 创建元素", async () => {
     assert("function", typeof GM_addElement, "GM_addElement 应该是函数");
 
     const div = GM_addElement("div", {
@@ -244,8 +244,39 @@
     assert(true, div && div.tagName === "DIV", "应该返回 div 元素");
     console.log("添加的元素:", div);
 
+    // 创建脚本元素测试
+    const script = GM_addElement("script", {
+      textContent: 'window.foo = "bar";',
+    });
+    assert(true, script && script.tagName === "SCRIPT", "应该返回 script 元素");
+    assert("bar", unsafeWindow.foo, "脚本内容应该执行，unsafeWindow.foo 应该是 'bar'");
+    console.log("添加的脚本元素:", script);
+
+    document.querySelector(".container").insertBefore(script, document.querySelector(".masthead"));
+
+    // onload 和 onerror 测试 - 插入图片元素
+    let img;
+    await new Promise((resolve, reject) => {
+      img = GM_addElement(document.body, "img", {
+        src: "https://www.tampermonkey.net/favicon.ico",
+        onload: () => {
+          console.log("图片加载成功");
+          resolve();
+        },
+        onerror: (error) => {
+          reject(new Error("图片加载失败: " + error));
+        },
+      });
+    });
+    assert(true, img && img.tagName === "IMG", "应该返回 img 元素");
+    console.log("添加的图片元素:", img);
+
     // 3秒后移除
-    setTimeout(() => div.remove(), 3000);
+    setTimeout(() => {
+      script.remove();
+      div.remove();
+      img.remove();
+    }, 3000);
   });
 
   // ============ GM_getResourceText/URL 测试 ============