|
| 1 | +--- |
| 2 | +title: TypeError Cannot read properties of undefined (reading 'options') in HTML5-based report viewers |
| 3 | +description: Learn how to resolve the TypeError about 'options' in HTML5-based report viewers. |
| 4 | +type: troubleshooting |
| 5 | +page_title: TypeError Cannot read properties of undefined (reading 'options') in HTML5-based report viewers |
| 6 | +meta_title: TypeError Cannot read properties of undefined (reading 'options') in HTML5-based report viewers |
| 7 | +slug: cannot-read-properties-of-undefined-reading-options |
| 8 | +tags: reporting, export, download, kendo ui, upgrade, options |
| 9 | +res_type: kb |
| 10 | +--- |
| 11 | + |
| 12 | +## Environment |
| 13 | + |
| 14 | +<table> |
| 15 | + <tbody> |
| 16 | + <tr> |
| 17 | + <td> Product </td> |
| 18 | + <td> Reporting </td> |
| 19 | + </tr> |
| 20 | + <tr> |
| 21 | + <td> Version </td> |
| 22 | + <td> 19.1.25.521+ </td> |
| 23 | + </tr> |
| 24 | + </tbody> |
| 25 | +</table> |
| 26 | + |
| 27 | +## Description |
| 28 | + |
| 29 | +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. |
| 30 | + |
| 31 | +## Cause |
| 32 | + |
| 33 | +The issue likely occurs due to an incompatibility between the report viewer and the [Kendo UI for jQuery](https://www.telerik.com/kendo-jquery-ui) 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. |
| 34 | + |
| 35 | +## Solution |
| 36 | + |
| 37 | +### Step 1: Check Current Kendo UI Version |
| 38 | + |
| 39 | +1. Open the browser console on the page containing the report viewer. |
| 40 | +1. Execute the following command: |
| 41 | + |
| 42 | + ````javascript |
| 43 | +kendo.version |
| 44 | +```` |
| 45 | +
|
| 46 | +
|
| 47 | +### Step 2: Determine Required Kendo UI Version |
| 48 | +
|
| 49 | +1. Visit the [Telerik Reporting Release History](https://www.telerik.com/support/whats-new/reporting/release-history) page. |
| 50 | +1. Locate your current Reporting version and open the corresponding page. |
| 51 | +1. Check the compatible Kendo UI for jQuery version listed in the release notes. |
| 52 | +1. If the Kendo UI version matches the required version for your Reporting release, continue with [Further Steps](#further-steps). If there is a mismatch, follow [step 3](#step-3-choose-a-resolution-method) to resolve the compatibility issue. |
| 53 | +
|
| 54 | +### Step 3: Choose a Resolution Method |
| 55 | +
|
| 56 | +#### Option A: Update Kendo UI for jQuery |
| 57 | +
|
| 58 | +Update your Kendo UI for jQuery reference to the compatible version based on the [step 1](#step-1-check-current-kendo-ui-version) and [step 2](#step-2-determine-required-kendo-ui-version). |
| 59 | +
|
| 60 | +#### Option B: Use Telerik Reporting's Kendo UI Subset |
| 61 | +
|
| 62 | +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: |
| 63 | +
|
| 64 | +````html |
| 65 | + <script src="api/reports/resources/js/telerikReportViewer-kendo"></script> |
| 66 | +```` |
| 67 | + |
| 68 | +>note This approach ensures compatibility when the report viewer and Reporting REST service versions match. |
| 69 | +
|
| 70 | +## Further Steps |
| 71 | + |
| 72 | +If you continue to experience issues after verifying the Kendo UI version, consider [capturing a HAR file](https://support.google.com/admanager/answer/10358597?hl=en#capture-your-http-network-session) using your browser's DevTools. Then, attach this file to a support ticket via the [Telerik Reporting support system](https://www.telerik.com/account/support-center/contact-us/technical-support). This will help the support team review the JavaScript files requested by your application and provide more targeted assistance. |
0 commit comments