javascript web worker 无法直接传递 idbkeyrangeonly,因为该对象是浏览器内部用于 indexeddb 操作的专用类型,不具备结构化克隆(structured clone)所需的序列化能力。要解决这个问题,你需要在调用方将 idbkeyrange 实例转换为一个纯数据对象(如包含 lower、upper、loweropen、upperopen 属性的 json 对象),通过 postmessage 发送给 worker;worker 收到后,再使用这些属性重新构造一个新的 idbkeyrange 实例。

如何将 IDBKeyRange 序列化为可传输对象
要将 IDBKeyRange 传递给 Worker,必须提取其关键属性并构建一个普通对象。你可以定义一个辅助函数,读取 IDBKeyRange 的 lower、upper、lowerOpen 和 upperOpen 属性,返回一个包含这些字段的 JSON 兼容对象。这样,postMessage 就能成功将其序列化为字符串或二进制格式发送出去。
{
function serializeKeyRange(keyRange) {
if (!keyRange) return null;
return {
lower: keyRange.lower,
upper: keyRange.upper,
lowerOpen: keyRange.lowerOpen,
upperOpen: keyRange.upperOpen
};
}
// 示例:创建一个范围并序列化
const range = IDBKeyRange.bound(10, 20);
const payload = serializeKeyRange(range);
console.log(payload); // { lower: 10, upper: 20, lowerOpen: false, upperOpen: false }运行上述代码,控制台会输出一个包含四个属性的普通对象。这个对象不包含任何引用关系,因此可以被结构化克隆算法正确处理。注意,如果 IDBKeyRange 的边界值是复杂对象(如数组或嵌套对象),它们也会被递归序列化,但需确保这些值本身也是可克隆的。
如何在 Worker 中反序列化 IDBKeyRange
在 Worker 端接收到序列化后的对象后,需要将其还原为 IDBKeyRange 实例。可以使用 IDBKeyRange.lowerBound()、IDBKeyRange.upperBound()、IDBKeyRange.bound() 或 IDBKeyRange.only() 等静态方法,根据传入的属性值重新创建范围。例如,如果收到一个包含 lower 和 upper 的对象,就调用 IDBKeyRange.bound() 来生成新的范围实例。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
立即学习“Java免费学习笔记(深入)”;
{
function deserializeKeyRange(data) {
if (!data) return null;
const { lower, upper, lowerOpen, upperOpen } = data;
if (lower !== undefined && upper !== undefined) {
return IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen);
}
if (lower !== undefined) {
return IDBKeyRange.lowerBound(lower, lowerOpen);
}
if (upper !== undefined) {
return IDBKeyRange.upperBound(upper, upperOpen);
}
// 如果没有明确边界,可能是一个无效范围,返回 null 或抛出错误
return null;
}
// 示例:在 Worker 中接收消息
self.onmessage = function(e) {
const serializedRange = e.data.range;
const keyRange = deserializeKeyRange(serializedRange);
console.log(keyRange); // IDBKeyRange 实例
};这段代码展示了如何根据接收到的数据动态选择正确的构造函数。如果数据只包含 lower,则使用 lowerBound;如果同时包含 lower 和 upper,则使用 bound。这样可以灵活处理各种类型的 IDBKeyRange。需要注意的是,反序列化后的 IDBKeyRange 是一个全新的实例,与原始实例没有关联,但这不影响其在 IndexedDB 查询中的使用。
基于 bound 方法生成的范围在 Worker 中的实际行为
当使用 IDBKeyRange.bound(10, 20) 生成范围并传递到 Worker 时,Worker 会收到一个 lower: 10, upper: 20, lowerOpen: false, upperOpen: false 的对象。反序列化后,Worker 中的 IDBKeyRange 实例将表示一个闭区间 [10, 20],即包含 10 和 20。这在 IndexedDB 查询中意味着索引值等于 10 或 20 的记录都会被匹配。如果原始范围是开区间,例如 IDBKeyRange.openBound(10, true),则序列化后的对象中 lowerOpen 为 true,Worker 反序列化后会得到一个左开右开的范围,排除 10 本身。

















