IndexedDB keyPath 特殊字符处理：理解规范与数据重塑

const db = ...; // 已打开的IndexedDB数据库实例
const transaction = db.transaction("myStore", "readwrite");
const objectStore = transaction.objectStore("myStore");

// 尝试为包含特殊字符的属性创建索引
// objectStore.createIndex("myIndex", "text@"); // 这将失败

// 原始数据对象
const originalData = {
    id: 1,
    "title@": "IndexedDB Special Characters",
    "text@": "This is some content with special characters in its property name."
};

// 数据预处理函数
function prepareDataForStorage(data) {
    const newData = { ...data }; // 创建一个副本，避免修改原始对象
    if (newData["title@"]) {
        newData.titleValid = newData["title@"]; // 创建一个有效标识符的别名
    }
    if (newData["text@"]) {
        newData.textValid = newData["text@"]; // 创建一个有效标识符的别名
    }
    return newData;
}

// 准备要存储的数据
const dataToStore = prepareDataForStorage(originalData);

// 在数据库升级时创建对象存储和索引
// 假设 db 是一个打开的数据库实例，并且处于 onupgradeneeded 事件中
function setupDatabase(db) {
    const objectStore = db.createObjectStore("myStore", { keyPath: "id" });
    // 使用别名属性创建索引
    objectStore.createIndex("titleIndex", "titleValid", { unique: false });
    objectStore.createIndex("textIndex", "textValid", { unique: false });
}

// 存储数据
// const transaction = db.transaction("myStore", "readwrite");
// const store = transaction.objectStore("myStore");
// store.add(dataToStore);

// 原始数据对象
const originalData = {
    id: 2,
    "title@": "Another IndexedDB Example",
    "text@": "More content with special characters."
};

// 数据预处理函数
function renamePropertiesForStorage(data) {
    const newData = { ...data };
    if (newData["title@"]) {
        newData.title = newData["title@"]; // 重命名
        delete newData["title@"]; // 删除原始属性以避免冗余
    }
    if (newData["text@"]) {
        newData.text = newData["text@"]; // 重命名
        delete newData["text@"];
    }
    return newData;
}

// 准备要存储的数据
const dataToStore = renamePropertiesForStorage(originalData);

// 在数据库升级时创建对象存储和索引
function setupDatabase(db) {
    const objectStore = db.createObjectStore("myStoreRenamed", { keyPath: "id" });
    // 使用重命名后的属性创建索引
    objectStore.createIndex("titleIndexRenamed", "title", { unique: false });
    objectStore.createIndex("textIndexRenamed", "text", { unique: false });
}

// 存储数据
// const transaction = db.transaction("myStoreRenamed", "readwrite");
// const store = transaction.objectStore("myStoreRenamed");
// store.add(dataToStore);

// 数据检索时的逆向操作（如果需要恢复原始属性名）
function restoreOriginalProperties(data) {
    const restoredData = { ...data };
    if (restoredData.title) {
        restoredData["title@"] = restoredData.title;
        delete restoredData.title;
    }
    if (restoredData.text) {
        restoredData["text@"] = restoredData.text;
        delete restoredData.text;
    }
    return restoredData;
}