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
- Open the browser console on the page containing the report viewer.
-
Execute the following command:
kendo.version
Step 2: Determine Required Kendo UI Version
- Visit the Telerik Reporting Release History page.
- Locate your current Reporting version and open the corresponding page.
- Check the compatible Kendo UI for jQuery version listed in the release notes.
- 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.