video-frame-tools 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RaineySpace
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,84 @@
+'use strict';
+
+// src/utils/createVideoElement.ts
+function createVideoElement(src) {
+  const videoEl = document.createElement("video");
+  videoEl.crossOrigin = "anonymous";
+  videoEl.preload = "metadata";
+  videoEl.muted = true;
+  videoEl.playsInline = true;
+  videoEl.src = src;
+  return videoEl;
+}
+
+// src/utils/events.ts
+async function awaitEvent(target, event, signal) {
+  return new Promise((resolve, reject) => {
+    var _a;
+    const onEvent = (evt) => {
+      cleanup();
+      resolve(evt);
+    };
+    const onAbort = () => {
+      var _a2;
+      cleanup();
+      reject((_a2 = signal == null ? void 0 : signal.reason) != null ? _a2 : new Error("\u64CD\u4F5C\u5DF2\u53D6\u6D88"));
+    };
+    const cleanup = () => {
+      target.removeEventListener(event, onEvent);
+      signal == null ? void 0 : signal.removeEventListener("abort", onAbort);
+    };
+    if (signal == null ? void 0 : signal.aborted) {
+      cleanup();
+      reject((_a = signal == null ? void 0 : signal.reason) != null ? _a : new Error("\u64CD\u4F5C\u5DF2\u53D6\u6D88"));
+    }
+    target.addEventListener(event, onEvent, { once: true });
+    if (signal) {
+      signal.addEventListener("abort", onAbort, { once: true });
+    }
+  });
+}
+
+// src/index.ts
+async function captureVideoFrame(video, time, signal) {
+  const videoEl = typeof video === "string" ? createVideoElement(video) : video;
+  if (videoEl.readyState < HTMLMediaElement.HAVE_METADATA) {
+    await awaitEvent(videoEl, "loadedmetadata", signal);
+    signal == null ? void 0 : signal.throwIfAborted();
+  }
+  const duration = Number.isFinite(videoEl.duration) ? videoEl.duration : time;
+  const clampedTime = Math.min(Math.max(time, 0), duration);
+  if (Math.abs(videoEl.currentTime - clampedTime) > 0.01) {
+    videoEl.currentTime = clampedTime;
+    await awaitEvent(videoEl, "seeked", signal);
+  } else if (videoEl.readyState < 2) {
+    await awaitEvent(videoEl, "loadeddata", signal);
+  }
+  signal == null ? void 0 : signal.throwIfAborted();
+  const bitmap = await createImageBitmap(videoEl);
+  signal == null ? void 0 : signal.throwIfAborted();
+  const canvas = typeof OffscreenCanvas !== "undefined" ? new OffscreenCanvas(bitmap.width, bitmap.height) : Object.assign(document.createElement("canvas"), {
+    width: bitmap.width,
+    height: bitmap.height
+  });
+  const ctx = canvas.getContext("2d");
+  if (!ctx) {
+    throw new Error("Canvas \u521D\u59CB\u5316\u5931\u8D25\uFF0C\u65E0\u6CD5\u751F\u6210\u5C01\u9762");
+  }
+  ctx.drawImage(bitmap, 0, 0);
+  const blob = canvas instanceof OffscreenCanvas ? await canvas.convertToBlob() : await new Promise((resolve, reject) => {
+    canvas.toBlob((result) => {
+      if (result) {
+        resolve(result);
+      } else {
+        reject(new Error("Canvas \u5BFC\u51FA\u5931\u8D25\uFF0C\u65E0\u6CD5\u751F\u6210\u5C01\u9762"));
+      }
+    });
+  });
+  signal == null ? void 0 : signal.throwIfAborted();
+  return blob;
+}
+
+exports.captureVideoFrame = captureVideoFrame;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/createVideoElement.ts","../src/utils/events.ts","../src/index.ts"],"names":["_a"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * 创建视频元素\n * @param src 视频地址\n * @returns 视频元素\n */\nexport function createVideoElement(src: string) {\n  const videoEl = document.createElement('video');\n  videoEl.crossOrigin = 'anonymous';\n  videoEl.preload = 'metadata';\n  videoEl.muted = true;\n  videoEl.playsInline = true;\n  videoEl.src = src;\n  return videoEl;\n}\n","export async function awaitEvent(target: EventTarget, event: string, signal?: AbortSignal) {\n  return new Promise<Event>((resolve, reject) => {\n    const onEvent = (evt: Event) => {\n      cleanup();\n      resolve(evt);\n    };\n\n    const onAbort = () => {\n      cleanup();\n      reject(signal?.reason ?? new Error('操作已取消'));\n    };\n\n    const cleanup = () => {\n      target.removeEventListener(event, onEvent);\n      signal?.removeEventListener('abort', onAbort);\n    };\n\n    if (signal?.aborted) {\n      cleanup();\n      reject(signal?.reason ?? new Error('操作已取消'));\n    }\n\n    target.addEventListener(event, onEvent, { once: true });\n    if (signal) {\n      signal.addEventListener('abort', onAbort, { once: true });\n    }\n  });\n}\n","import { createVideoElement } from './utils/createVideoElement';\nimport { awaitEvent } from './utils/events';\n\n/**\n * 捕获视频指定时间点截图\n * @param video - 视频 URL\n * @param time - 时间点\n * @param signal - AbortSignal 用于取消操作\n * @returns Blob\n */\nexport async function captureVideoFrame(\n  video: string | HTMLVideoElement,\n  time: number,\n  signal?: AbortSignal,\n) {\n  const videoEl = typeof video === 'string' ? createVideoElement(video) : video;\n  \n  // 确保视频元数据加载完成\n  if (videoEl.readyState < HTMLMediaElement.HAVE_METADATA) {\n    await awaitEvent(videoEl, 'loadedmetadata', signal);\n    signal?.throwIfAborted();\n  }\n\n  const duration = Number.isFinite(videoEl.duration) ? videoEl.duration : time;\n  const clampedTime = Math.min(Math.max(time, 0), duration);\n\n  if (Math.abs(videoEl.currentTime - clampedTime) > 0.01) {\n    videoEl.currentTime = clampedTime;\n    await awaitEvent(videoEl, 'seeked', signal);\n  } else if (videoEl.readyState < 2) {\n    await awaitEvent(videoEl, 'loadeddata', signal);\n  }\n\n  signal?.throwIfAborted();\n\n  const bitmap = await createImageBitmap(videoEl);\n  signal?.throwIfAborted();\n  const canvas =\n    typeof OffscreenCanvas !== 'undefined'\n      ? new OffscreenCanvas(bitmap.width, bitmap.height)\n      : Object.assign(document.createElement('canvas'), {\n          width: bitmap.width,\n          height: bitmap.height,\n        });\n\n  const ctx = canvas.getContext('2d');\n  if (!ctx) {\n    throw new Error('Canvas 初始化失败，无法生成封面');\n  }\n  ctx.drawImage(bitmap, 0, 0);\n  const blob =\n    canvas instanceof OffscreenCanvas\n      ? await canvas.convertToBlob()\n      : await new Promise<Blob>((resolve, reject) => {\n          canvas.toBlob((result) => {\n            if (result) {\n              resolve(result);\n            } else {\n              reject(new Error('Canvas 导出失败，无法生成封面'));\n            }\n          });\n        });\n  signal?.throwIfAborted();\n  return blob;\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,10 @@
+/**
+ * 捕获视频指定时间点截图
+ * @param video - 视频 URL
+ * @param time - 时间点
+ * @param signal - AbortSignal 用于取消操作
+ * @returns Blob
+ */
+declare function captureVideoFrame(video: string | HTMLVideoElement, time: number, signal?: AbortSignal): Promise<Blob>;
+
+export { captureVideoFrame };

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 捕获视频指定时间点截图
+ * @param video - 视频 URL
+ * @param time - 时间点
+ * @param signal - AbortSignal 用于取消操作
+ * @returns Blob
+ */
+declare function captureVideoFrame(video: string | HTMLVideoElement, time: number, signal?: AbortSignal): Promise<Blob>;
+
+export { captureVideoFrame };

package/dist/index.js

@@ -0,0 +1,82 @@
+// src/utils/createVideoElement.ts
+function createVideoElement(src) {
+  const videoEl = document.createElement("video");
+  videoEl.crossOrigin = "anonymous";
+  videoEl.preload = "metadata";
+  videoEl.muted = true;
+  videoEl.playsInline = true;
+  videoEl.src = src;
+  return videoEl;
+}
+
+// src/utils/events.ts
+async function awaitEvent(target, event, signal) {
+  return new Promise((resolve, reject) => {
+    var _a;
+    const onEvent = (evt) => {
+      cleanup();
+      resolve(evt);
+    };
+    const onAbort = () => {
+      var _a2;
+      cleanup();
+      reject((_a2 = signal == null ? void 0 : signal.reason) != null ? _a2 : new Error("\u64CD\u4F5C\u5DF2\u53D6\u6D88"));
+    };
+    const cleanup = () => {
+      target.removeEventListener(event, onEvent);
+      signal == null ? void 0 : signal.removeEventListener("abort", onAbort);
+    };
+    if (signal == null ? void 0 : signal.aborted) {
+      cleanup();
+      reject((_a = signal == null ? void 0 : signal.reason) != null ? _a : new Error("\u64CD\u4F5C\u5DF2\u53D6\u6D88"));
+    }
+    target.addEventListener(event, onEvent, { once: true });
+    if (signal) {
+      signal.addEventListener("abort", onAbort, { once: true });
+    }
+  });
+}
+
+// src/index.ts
+async function captureVideoFrame(video, time, signal) {
+  const videoEl = typeof video === "string" ? createVideoElement(video) : video;
+  if (videoEl.readyState < HTMLMediaElement.HAVE_METADATA) {
+    await awaitEvent(videoEl, "loadedmetadata", signal);
+    signal == null ? void 0 : signal.throwIfAborted();
+  }
+  const duration = Number.isFinite(videoEl.duration) ? videoEl.duration : time;
+  const clampedTime = Math.min(Math.max(time, 0), duration);
+  if (Math.abs(videoEl.currentTime - clampedTime) > 0.01) {
+    videoEl.currentTime = clampedTime;
+    await awaitEvent(videoEl, "seeked", signal);
+  } else if (videoEl.readyState < 2) {
+    await awaitEvent(videoEl, "loadeddata", signal);
+  }
+  signal == null ? void 0 : signal.throwIfAborted();
+  const bitmap = await createImageBitmap(videoEl);
+  signal == null ? void 0 : signal.throwIfAborted();
+  const canvas = typeof OffscreenCanvas !== "undefined" ? new OffscreenCanvas(bitmap.width, bitmap.height) : Object.assign(document.createElement("canvas"), {
+    width: bitmap.width,
+    height: bitmap.height
+  });
+  const ctx = canvas.getContext("2d");
+  if (!ctx) {
+    throw new Error("Canvas \u521D\u59CB\u5316\u5931\u8D25\uFF0C\u65E0\u6CD5\u751F\u6210\u5C01\u9762");
+  }
+  ctx.drawImage(bitmap, 0, 0);
+  const blob = canvas instanceof OffscreenCanvas ? await canvas.convertToBlob() : await new Promise((resolve, reject) => {
+    canvas.toBlob((result) => {
+      if (result) {
+        resolve(result);
+      } else {
+        reject(new Error("Canvas \u5BFC\u51FA\u5931\u8D25\uFF0C\u65E0\u6CD5\u751F\u6210\u5C01\u9762"));
+      }
+    });
+  });
+  signal == null ? void 0 : signal.throwIfAborted();
+  return blob;
+}
+
+export { captureVideoFrame };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/createVideoElement.ts","../src/utils/events.ts","../src/index.ts"],"names":["_a"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * 创建视频元素\n * @param src 视频地址\n * @returns 视频元素\n */\nexport function createVideoElement(src: string) {\n  const videoEl = document.createElement('video');\n  videoEl.crossOrigin = 'anonymous';\n  videoEl.preload = 'metadata';\n  videoEl.muted = true;\n  videoEl.playsInline = true;\n  videoEl.src = src;\n  return videoEl;\n}\n","export async function awaitEvent(target: EventTarget, event: string, signal?: AbortSignal) {\n  return new Promise<Event>((resolve, reject) => {\n    const onEvent = (evt: Event) => {\n      cleanup();\n      resolve(evt);\n    };\n\n    const onAbort = () => {\n      cleanup();\n      reject(signal?.reason ?? new Error('操作已取消'));\n    };\n\n    const cleanup = () => {\n      target.removeEventListener(event, onEvent);\n      signal?.removeEventListener('abort', onAbort);\n    };\n\n    if (signal?.aborted) {\n      cleanup();\n      reject(signal?.reason ?? new Error('操作已取消'));\n    }\n\n    target.addEventListener(event, onEvent, { once: true });\n    if (signal) {\n      signal.addEventListener('abort', onAbort, { once: true });\n    }\n  });\n}\n","import { createVideoElement } from './utils/createVideoElement';\nimport { awaitEvent } from './utils/events';\n\n/**\n * 捕获视频指定时间点截图\n * @param video - 视频 URL\n * @param time - 时间点\n * @param signal - AbortSignal 用于取消操作\n * @returns Blob\n */\nexport async function captureVideoFrame(\n  video: string | HTMLVideoElement,\n  time: number,\n  signal?: AbortSignal,\n) {\n  const videoEl = typeof video === 'string' ? createVideoElement(video) : video;\n  \n  // 确保视频元数据加载完成\n  if (videoEl.readyState < HTMLMediaElement.HAVE_METADATA) {\n    await awaitEvent(videoEl, 'loadedmetadata', signal);\n    signal?.throwIfAborted();\n  }\n\n  const duration = Number.isFinite(videoEl.duration) ? videoEl.duration : time;\n  const clampedTime = Math.min(Math.max(time, 0), duration);\n\n  if (Math.abs(videoEl.currentTime - clampedTime) > 0.01) {\n    videoEl.currentTime = clampedTime;\n    await awaitEvent(videoEl, 'seeked', signal);\n  } else if (videoEl.readyState < 2) {\n    await awaitEvent(videoEl, 'loadeddata', signal);\n  }\n\n  signal?.throwIfAborted();\n\n  const bitmap = await createImageBitmap(videoEl);\n  signal?.throwIfAborted();\n  const canvas =\n    typeof OffscreenCanvas !== 'undefined'\n      ? new OffscreenCanvas(bitmap.width, bitmap.height)\n      : Object.assign(document.createElement('canvas'), {\n          width: bitmap.width,\n          height: bitmap.height,\n        });\n\n  const ctx = canvas.getContext('2d');\n  if (!ctx) {\n    throw new Error('Canvas 初始化失败，无法生成封面');\n  }\n  ctx.drawImage(bitmap, 0, 0);\n  const blob =\n    canvas instanceof OffscreenCanvas\n      ? await canvas.convertToBlob()\n      : await new Promise<Blob>((resolve, reject) => {\n          canvas.toBlob((result) => {\n            if (result) {\n              resolve(result);\n            } else {\n              reject(new Error('Canvas 导出失败，无法生成封面'));\n            }\n          });\n        });\n  signal?.throwIfAborted();\n  return blob;\n}\n"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "video-frame-tools",
+  "version": "0.0.1",
+  "description": "一个用于提取视频帧的工具",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "video",
+    "frame",
+    "screenshot"
+  ],
+  "author": "RaineySpace",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RaineySpace/video-frame-tools"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.27.1",
+    "@types/node": "^22.10.2",
+    "tsup": "^8.0.2",
+    "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "changeset publish"
+  }
+}