Health Check Error: Removed jQuery Function(s) Detected

    Overview

    The Health Check wizard must be run when upgrading in order to evaluate your instance’s ability to move to the target version. During the health check, various types of issues may be detected which can affect your ability to upgrade. This article will cover the “Removed jQuery function(s) detected” error reported by the health check.

    Symptoms

    This error generates an output similar to the following in health check:

    HealthCheckError

    Resolution

    The generated error message will help determine the contents of the file causing the health check error. To address this issue, the code-level customization will need to be corrected or removed before proceeding with the upgrade.

    jQuery 1.12.4 was upgraded to 3.3.1 and jQuery Migrate 1.4.1 was upgraded to 3.0.1, resulting in the removal of the following functions:

    • jQuery.browser()
    • jQuery.clean()
    • jQuery.event.handle()
    • jQuery.offset.bodyOffset()
    • jQuery.sub()
    • jQuery.deletedIds
    • jQuery.uuid
    • jQuery.attrFn
    • .andSelf() (deprecated and replaced by .addBack(selector))
    • .data("events")
    • .die()
    • .live()

    The example error shown above was caused by a problem in the named file, ./custom/modules/Tasks/clients/base/views/record/record.js, which contains one of the removed jQuery functions. Developers must either remove the function’s usages from their code, replace it with a supported function, or disable the specified file.

    Once the necessary change has been made, please navigate to Admin > Repair and perform a “Quick Repair and Rebuild”. Then, run the health check again to confirm that the error is no longer reported.

    As we have upgraded to jQuery 3.3.1 and jQuery Migrate 3.0.1, we recommend that developers review their features for compatibility post-upgrade. The jQuery upgrade guides can be found on the jQuery website:

    in Troubleshooting Health Check Output

    Reach out to us for help