如何在QtScript中注册QList<QMap<QString,QString>>为元类型？

我正好处理过类似的嵌套容器类型注册问题，咱们一步步来解决：

1. 先注册内部的QMap<QString, QString>类型 #

首先得确保内层的QMap<QString, QString>能被脚本引擎正确识别，因为外层的QList依赖它的转换逻辑。我们需要实现两个转换函数：把QMap转成QScriptValue，以及反向转换。

#include <QScriptEngine>
#include <QMap>
#include <QList>

// 将QMap<QString, QString>转换为QScriptValue（JS对象）
QScriptValue qMapToScriptValue(QScriptEngine *engine, const QMap<QString, QString> &map)
{
    QScriptValue obj = engine->newObject();
    for (auto it = map.constBegin(); it != map.constEnd(); ++it) {
        obj.setProperty(it.key(), engine->toScriptValue(it.value()));
    }
    return obj;
}

// 将QScriptValue（JS对象）转换回QMap<QString, QString>
void qMapFromScriptValue(const QScriptValue &obj, QMap<QString, QString> &map)
{
    map.clear();
    QScriptValueIterator it(obj);
    while (it.hasNext()) {
        it.next();
        if (it.value().isString()) {
            map.insert(it.name(), it.value().toString());
        }
    }
}

然后在你的引擎初始化代码中注册这个类型：

QScriptEngine engine;
// 注册QMap<QString, QString>
qScriptRegisterMetaType(&engine, qMapToScriptValue, qMapFromScriptValue);

2. 注册外层的QList<QMap<QString, QString>>类型 #

接下来处理外层的QList，同样实现对应的转换函数，把QList转成JS数组，每个元素是已经注册好的QMap对应的JS对象：

// 将QList<QMap<QString, QString>>转换为QScriptValue（JS数组）
QScriptValue qListMapToScriptValue(QScriptEngine *engine, const QList<QMap<QString, QString>> &list)
{
    QScriptValue array = engine->newArray(list.size());
    for (int i = 0; i < list.size(); ++i) {
        array.setProperty(i, engine->toScriptValue(list.at(i)));
    }
    return array;
}

// 将QScriptValue（JS数组）转换回QList<QMap<QString, QString>>
void qListMapFromScriptValue(const QScriptValue &array, QList<QMap<QString, QString>> &list)
{
    list.clear();
    if (!array.isArray()) {
        return;
    }
    quint32 length = array.property("length").toUInt32();
    for (quint32 i = 0; i < length; ++i) {
        QScriptValue elem = array.property(i);
        QMap<QString, QString> map;
        qMapFromScriptValue(elem, map);
        list.append(map);
    }
}

同样在引擎初始化时注册这个嵌套类型：

// 注册QList<QMap<QString, QString>>
qScriptRegisterMetaType(&engine, qListMapToScriptValue, qListMapFromScriptValue);

3. 使用示例：传递数据到JavaScript #

现在你可以直接把QList<QMap<QString, QString>>对象传入JS环境了：

// 构造测试数据
QList<QMap<QString, QString>> dataList;
QMap<QString, QString> map1;
map1.insert("name", "Alice");
map1.insert("age", "25");
dataList.append(map1);

QMap<QString, QString> map2;
map2.insert("name", "Bob");
map2.insert("age", "30");
dataList.append(map2);

// 将数据暴露给JS
engine.globalObject().setProperty("userList", engine->toScriptValue(dataList));

// 测试JS代码
QString jsCode = R"(
    for (let i = 0; i < userList.length; i++) {
        let user = userList[i];
        console.log("Name: " + user.name + ", Age: " + user.age);
    }
)";

QScriptValue result = engine.evaluate(jsCode);
if (result.isError()) {
    qDebug() << "JS Error:" << result.toString();
}

关键注意事项 #

• 注册顺序很重要：必须先注册内层的QMap类型，再注册外层的QList类型，否则引擎无法正确转换嵌套元素。
• 类型安全检查：在fromScriptValue函数中最好加入类型检查（比如判断是否是数组/对象），避免非法输入导致崩溃。
• Qt版本兼容性：这个方法适用于Qt 4.x到Qt 5.x（注意Qt 5之后QScriptEngine依然可用，但如果用Qt Quick的话可能需要用QJSEngine，逻辑类似）。

内容的提问来源于stack exchange，提问作者Sasha Demyanik