From c003bf3823bd2835df9cfe49a96ba882e488f934 Mon Sep 17 00:00:00 2001 From: petar-i-todorov Date: Tue, 22 Jul 2025 18:15:36 +0300 Subject: [PATCH 1/4] docs: add kb on typeerror-reading-options --- ...ad-properties-undefined-reading-options.md | 124 ++++++++++++++++++ ...d-properties-underfined-reading-options.md | 70 ++++++++++ 2 files changed, 194 insertions(+) create mode 100644 knowledge-base/typeerror-cannot-read-properties-undefined-reading-options.md create mode 100644 knowledge-base/typeerror-cannot-read-properties-underfined-reading-options.md diff --git a/knowledge-base/typeerror-cannot-read-properties-undefined-reading-options.md b/knowledge-base/typeerror-cannot-read-properties-undefined-reading-options.md new file mode 100644 index 000000000..cc536a1da --- /dev/null +++ b/knowledge-base/typeerror-cannot-read-properties-undefined-reading-options.md @@ -0,0 +1,124 @@ +--- +title: TypeError Cannot read properties of undefined (reading 'options') in HTML5-based report viewers +description: Learn how to resolve the TypeError about 'options' in HTML5-based report viewers after upgrading Telerik Reporting. +type: troubleshooting +page_title: TypeError Cannot read properties of undefined (reading 'options') in HTML5-based report viewers +meta_title: TypeError Cannot read properties of undefined (reading 'options') in HTML5-based report viewers +slug: cannot-read-properties-of-undefined-reading-options +tags: reporting, export, download, kendo ui, upgrade, options, javascript, html5 +res_type: kb +--- + +## Environment + + + + + + + + + + + + + + + + +
Product Telerik Reporting
Version 19.1.25.521 and later
Report Viewer HTML5-based Report Viewer
+ +## Description + +After upgrading Telerik Reporting from version `19.0.25.313` to `19.1.25.521` or later, the export functionality in HTML5-based report viewers stops working. Export operations (such as downloading reports to Excel, PDF, or other formats) fail to initiate, and the following JavaScript error appears in the browser console: + +``` +TypeError: Cannot read properties of undefined (reading 'options') +``` + +The REST service continues to respond successfully for initial requests, indicating this is a client-side JavaScript compatibility issue. + +## Error Details + +This error typically occurs during export operations and may manifest as: +- Export buttons becoming unresponsive +- Downloads not starting when clicking export buttons +- JavaScript console errors preventing report viewer functionality + +## Cause + +The issue occurs due to version incompatibility between the HTML5 Report Viewer and the Kendo UI for jQuery library referenced on the page. + +When Telerik Reporting is upgraded, it is built against a specific version of Kendo UI for jQuery. If your page references an older or incompatible version of Kendo UI, it can cause JavaScript errors in the report viewer's export functionality. + +**Example**: Telerik Reporting version `19.1.25.521` is built against Kendo UI for jQuery version `2025.1.227`. Using an older Kendo UI version will cause client-side compatibility issues. + +## 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: + ```javascript + kendo.version + ``` +3. Note the returned version number + +### Step 2: Determine Required Kendo UI Version + +1. Visit the [Telerik Reporting Release History](https://www.telerik.com/support/whats-new/reporting/release-history) +2. Locate your current Reporting version +3. Check the compatible Kendo UI for jQuery version listed in the release notes + +### Step 3: Choose a Resolution Method + +#### Option A: Update Kendo UI for jQuery (Recommended) + +Update your Kendo UI for jQuery reference to the compatible version: + +- For Reporting version `19.1.25.521`: Use Kendo UI for jQuery version `2025.1.227` or higher +- For other Reporting versions: Check the specific requirement in the Release History + +#### Option B: Use Telerik Reporting's Kendo UI Subset + +If your page doesn't use other Kendo UI components, replace the Kendo UI script reference with the subset provided by Telerik Reporting: + +```html + +``` + +**Note**: This approach ensures compatibility when the report viewer and Reporting REST service versions match. + +## Prerequisites + +- Access to modify JavaScript references on the page +- Administrative access to update Kendo UI for jQuery (for Option A) +- Telerik Reporting REST service running + +## Verification + +After implementing the solution: + +1. Clear browser cache +2. Reload the page with the report viewer +3. Test export functionality by attempting to download a report +4. Verify no JavaScript errors appear in the browser console + +## See Also + +- [Telerik Reporting Release History](https://www.telerik.com/support/whats-new/reporting/release-history) +- [Kendo UI for jQuery Documentation](https://www.telerik.com/kendo-jquery-ui) + +## Further Steps + +If the issue persists after implementing the above solutions: + +1. [Generate a HAR file](https://support.google.com/admanager/answer/10358597?hl=en#capture-your-http-network-session) to capture network activity +2. Submit a support ticket through the [Telerik Reporting support system](https://www.telerik.com/account/support-center/contact-us/technical-support) +3. Attach the HAR file so a support engineer can analyze the JavaScript file requests and responses + +Include the following information in your support ticket: +- Current Telerik Reporting version +- Current Kendo UI for jQuery version +- Browser and version information +- Steps to reproduce the issue diff --git a/knowledge-base/typeerror-cannot-read-properties-underfined-reading-options.md b/knowledge-base/typeerror-cannot-read-properties-underfined-reading-options.md new file mode 100644 index 000000000..6a7e105bc --- /dev/null +++ b/knowledge-base/typeerror-cannot-read-properties-underfined-reading-options.md @@ -0,0 +1,70 @@ +--- +title: TypeError Cannot read properties of undefined (reading 'options') in HTML5-based report viewers +description: Learn how to resolve the TypeError about 'options' in HTML5-based report viewers. +type: troubleshooting +page_title: TypeError Cannot read properties of undefined (reading 'options') in HTML5-based report viewers +meta_title: TypeError Cannot read properties of undefined (reading 'options') in HTML5-based report viewers +slug: cannot-read-properties-of-undefined-reading-options +tags: reporting, export, download, kendo ui, upgrade, options +res_type: kb +--- + +## 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](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. + +## Solution + +### Step 1: Check Current Kendo UI Version + +1. Open the browser console on the page containing the report viewer. +1. Execute the following command: + ````javascript + kendo.version + ```` + +### Step 2: Determine Required Kendo UI Version + +1. Visit the [Telerik Reporting Release History](https://www.telerik.com/support/whats-new/reporting/release-history) page. +1. Locate your current Reporting version and open the corresponding page. +1. Check the compatible Kendo UI for jQuery version listed in the release notes. +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. + +### 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](#step-1-check-current-kendo-ui-version) and [step 2](#step-2-determine-required-kendo-ui-version). + +#### 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: + +```html + +``` + +>note 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](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. \ No newline at end of file From 382031b4e2dc73332cfe44300787c980a26e5917 Mon Sep 17 00:00:00 2001 From: petar-i-todorov Date: Tue, 22 Jul 2025 18:17:11 +0300 Subject: [PATCH 2/4] docs: remove redundant file --- ...ad-properties-undefined-reading-options.md | 124 ------------------ 1 file changed, 124 deletions(-) delete mode 100644 knowledge-base/typeerror-cannot-read-properties-undefined-reading-options.md diff --git a/knowledge-base/typeerror-cannot-read-properties-undefined-reading-options.md b/knowledge-base/typeerror-cannot-read-properties-undefined-reading-options.md deleted file mode 100644 index cc536a1da..000000000 --- a/knowledge-base/typeerror-cannot-read-properties-undefined-reading-options.md +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: TypeError Cannot read properties of undefined (reading 'options') in HTML5-based report viewers -description: Learn how to resolve the TypeError about 'options' in HTML5-based report viewers after upgrading Telerik Reporting. -type: troubleshooting -page_title: TypeError Cannot read properties of undefined (reading 'options') in HTML5-based report viewers -meta_title: TypeError Cannot read properties of undefined (reading 'options') in HTML5-based report viewers -slug: cannot-read-properties-of-undefined-reading-options -tags: reporting, export, download, kendo ui, upgrade, options, javascript, html5 -res_type: kb ---- - -## Environment - - - - - - - - - - - - - - - - -
Product Telerik Reporting
Version 19.1.25.521 and later
Report Viewer HTML5-based Report Viewer
- -## Description - -After upgrading Telerik Reporting from version `19.0.25.313` to `19.1.25.521` or later, the export functionality in HTML5-based report viewers stops working. Export operations (such as downloading reports to Excel, PDF, or other formats) fail to initiate, and the following JavaScript error appears in the browser console: - -``` -TypeError: Cannot read properties of undefined (reading 'options') -``` - -The REST service continues to respond successfully for initial requests, indicating this is a client-side JavaScript compatibility issue. - -## Error Details - -This error typically occurs during export operations and may manifest as: -- Export buttons becoming unresponsive -- Downloads not starting when clicking export buttons -- JavaScript console errors preventing report viewer functionality - -## Cause - -The issue occurs due to version incompatibility between the HTML5 Report Viewer and the Kendo UI for jQuery library referenced on the page. - -When Telerik Reporting is upgraded, it is built against a specific version of Kendo UI for jQuery. If your page references an older or incompatible version of Kendo UI, it can cause JavaScript errors in the report viewer's export functionality. - -**Example**: Telerik Reporting version `19.1.25.521` is built against Kendo UI for jQuery version `2025.1.227`. Using an older Kendo UI version will cause client-side compatibility issues. - -## 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: - ```javascript - kendo.version - ``` -3. Note the returned version number - -### Step 2: Determine Required Kendo UI Version - -1. Visit the [Telerik Reporting Release History](https://www.telerik.com/support/whats-new/reporting/release-history) -2. Locate your current Reporting version -3. Check the compatible Kendo UI for jQuery version listed in the release notes - -### Step 3: Choose a Resolution Method - -#### Option A: Update Kendo UI for jQuery (Recommended) - -Update your Kendo UI for jQuery reference to the compatible version: - -- For Reporting version `19.1.25.521`: Use Kendo UI for jQuery version `2025.1.227` or higher -- For other Reporting versions: Check the specific requirement in the Release History - -#### Option B: Use Telerik Reporting's Kendo UI Subset - -If your page doesn't use other Kendo UI components, replace the Kendo UI script reference with the subset provided by Telerik Reporting: - -```html - -``` - -**Note**: This approach ensures compatibility when the report viewer and Reporting REST service versions match. - -## Prerequisites - -- Access to modify JavaScript references on the page -- Administrative access to update Kendo UI for jQuery (for Option A) -- Telerik Reporting REST service running - -## Verification - -After implementing the solution: - -1. Clear browser cache -2. Reload the page with the report viewer -3. Test export functionality by attempting to download a report -4. Verify no JavaScript errors appear in the browser console - -## See Also - -- [Telerik Reporting Release History](https://www.telerik.com/support/whats-new/reporting/release-history) -- [Kendo UI for jQuery Documentation](https://www.telerik.com/kendo-jquery-ui) - -## Further Steps - -If the issue persists after implementing the above solutions: - -1. [Generate a HAR file](https://support.google.com/admanager/answer/10358597?hl=en#capture-your-http-network-session) to capture network activity -2. Submit a support ticket through the [Telerik Reporting support system](https://www.telerik.com/account/support-center/contact-us/technical-support) -3. Attach the HAR file so a support engineer can analyze the JavaScript file requests and responses - -Include the following information in your support ticket: -- Current Telerik Reporting version -- Current Kendo UI for jQuery version -- Browser and version information -- Steps to reproduce the issue From 92d8de19c07a4357a1e837fcfa3c2374282f29a9 Mon Sep 17 00:00:00 2001 From: petar-i-todorov Date: Tue, 22 Jul 2025 18:20:35 +0300 Subject: [PATCH 3/4] docs: fix backticks --- ...ror-cannot-read-properties-underfined-reading-options.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/knowledge-base/typeerror-cannot-read-properties-underfined-reading-options.md b/knowledge-base/typeerror-cannot-read-properties-underfined-reading-options.md index 6a7e105bc..b42663307 100644 --- a/knowledge-base/typeerror-cannot-read-properties-underfined-reading-options.md +++ b/knowledge-base/typeerror-cannot-read-properties-underfined-reading-options.md @@ -59,9 +59,9 @@ Update your Kendo UI for jQuery reference to the compatible version based on the 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: -```html - -``` +````html + +```` >note This approach ensures compatibility when the report viewer and Reporting REST service versions match. From 7b218b561e56709dab166762427902e2a9013d94 Mon Sep 17 00:00:00 2001 From: Todor Arabadzhiev Date: Tue, 22 Jul 2025 18:36:46 +0300 Subject: [PATCH 4/4] Update typeerror-cannot-read-properties-underfined-reading-options.md --- ...not-read-properties-underfined-reading-options.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/knowledge-base/typeerror-cannot-read-properties-underfined-reading-options.md b/knowledge-base/typeerror-cannot-read-properties-underfined-reading-options.md index b42663307..47e9d488f 100644 --- a/knowledge-base/typeerror-cannot-read-properties-underfined-reading-options.md +++ b/knowledge-base/typeerror-cannot-read-properties-underfined-reading-options.md @@ -38,9 +38,11 @@ The issue likely occurs due to an incompatibility between the report viewer and 1. Open the browser console on the page containing the report viewer. 1. Execute the following command: - ````javascript - kendo.version - ```` + + ````javascript +kendo.version +```` + ### Step 2: Determine Required Kendo UI Version @@ -60,11 +62,11 @@ Update your Kendo UI for jQuery reference to the compatible version based on the 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: ````html - + ```` >note 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](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. \ No newline at end of file +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.