New to Telerik Reporting? Download free 30-day trial

TypeError Cannot read properties of undefined (reading 'options') in HTML5-based report viewers

Environment

Product Reporting
Version 19.1.25.521+

Description

After updating Telerik Reporting from version 19.0.25.313 to 19.1.25.521, the export functionality (for example, downloading to Excel) no longer works. The button fails to initiate the download, and there is a TypeError: Cannot read properties of undefined (reading 'options') error in the browser console. The initial REST service responses are successful, suggesting a frontend issue.

Cause

The issue likely occurs due to an incompatibility between the report viewer and the Kendo UI for jQuery version referenced on the page. For example, Reporting version (19.1.25.521) is built against Kendo UI for jQuery version 2025.1.227, while an older Kendo UI version may cause client-side errors.

Solution

Step 1: Check Current Kendo UI Version

  1. Open the browser console on the page containing the report viewer.
  2. Execute the following command:

    kendo.version
    

Step 2: Determine Required Kendo UI Version

  1. Visit the Telerik Reporting Release History page.
  2. Locate your current Reporting version and open the corresponding page.
  3. Check the compatible Kendo UI for jQuery version listed in the release notes.
  4. If the Kendo UI version matches the required version for your Reporting release, continue with Further Steps. If there is a mismatch, follow step 3 to resolve the compatibility issue.

Step 3: Choose a Resolution Method

Option A: Update Kendo UI for jQuery

Update your Kendo UI for jQuery reference to the compatible version based on the step 1 and step 2.

Option B: Use Telerik Reporting's Kendo UI Subset

If your page does not use other Kendo UI components, replace the Kendo UI script reference with the subset provided by the Reporting REST service:

    <script src="api/reports/resources/js/telerikReportViewer-kendo"></script>

This approach ensures compatibility when the report viewer and Reporting REST service versions match.

Further Steps

If you continue to experience issues after verifying the Kendo UI version, consider capturing a HAR file using your browser's DevTools. Then, attach this file to a support ticket via the Telerik Reporting support system. This will help the support team review the JavaScript files requested by your application and provide more targeted assistance.

In this article