Function _createWrappersForPlatformSpecificNamespace

modules/core/_common.js:128–176

(namespace)

}

function _createWrappersForPlatformSpecificNamespace(namespace) {
    // Redefine namespace properties with platform-specific implementations to
    // be backward compatible with gi-repository 1.0, however when possible we
    // notify a deprecation warning, to ensure that the surrounding code is
    // updated.

    let platformNamespace;
    let platformName;
    const namespaceName = namespace.__name__;
    try {
        platformName = 'Unix';
        platformNamespace = imports.gi[`${namespaceName}${platformName}`];
    } catch {
        try {
            platformName = 'Win32';
            platformNamespace = imports.gi[`${namespaceName}${platformName}`];
        } catch {
            return;
        }
    }

    const platformNameLower = platformName.toLowerCase();
    Object.entries(Object.getOwnPropertyDescriptors(platformNamespace)).forEach(([prop, desc]) => {
        let genericProp = prop;

        const originalValue = platformNamespace[prop];
        const gtypeName = originalValue.$gtype?.name;
        if (gtypeName?.startsWith(`G${platformName}`))
            genericProp = `${platformName}${prop}`;
        else if (originalValue instanceof Function &&
            originalValue.name.startsWith(`g_${platformNameLower}_`))
            genericProp = `${platformNameLower}_${prop}`;
        else if (originalValue instanceof Object &&
                 (!gtypeName || gtypeName === 'void') &&
                 (!originalValue.name || originalValue.name.startsWith(
                     `${namespaceName}${platformName}_`)))
            genericProp = `${platformName}${prop}`;

        if (Object.hasOwn(namespace, genericProp)) {
            console.log(`${namespaceName} already contains property ${genericProp}`);
            namespace[genericProp] = originalValue;
            return;
        }

        _defineDeprecatedWrapperForDescriptor(
            namespace, platformNamespace, genericProp, prop, desc,
            PLATFORM_SPECIFIC_TYPELIB);
    });
}

function _defineDeprecatedWrapperForDescriptor(
    namespace, newNamespace, oldName, newName, desc, deprecationReason = RENAMED) {