Skip to content

Commit 12895f2

Browse files
docs: add kb on typeerror-reading-options (#1758)
* docs: add kb on typeerror-reading-options * docs: remove redundant file * docs: fix backticks * Update typeerror-cannot-read-properties-underfined-reading-options.md --------- Co-authored-by: Todor Arabadzhiev <[email protected]>
1 parent 32de2ed commit 12895f2

File tree

1 file changed

+72
-0
lines changed

1 file changed

+72
-0
lines changed
Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
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

Comments
 (0)