Skip to content

Latest commit

 

History

History
124 lines (67 loc) · 3.79 KB

An_Empty_Page_Comes_Up_51fe8f4.md

File metadata and controls

124 lines (67 loc) · 3.79 KB
loio
51fe8f410623483097c292514c241eeb

view on: demo kit nightly build | demo kit latest release

An Empty Page Comes Up

You find yourself in one of these situations:

  • The browser shows an empty page: there's no content and no error message is displayed

  • An Uncaught Error message is shown in the developer console

Preview

The browser displays an empty page and an Uncaught Error is issued in the console

Root Cause

This can happen for one of the following reasons:

  • A critical reference error is prohibiting the app from starting.

  • A syntax error is stopping the execution of your application code.

  • A parsing error has occurred in an XML view.

  • The tag of the control is written with lowercase letters.

  • The root view is missing a root control.

Resolution

Console shows "ReferenceError: sap is not defined"

Have a look at the resource path in the bootstrap of the HTML page you are trying to open. The path to the file sap-ui-core.js is probably incorrect and needs to point to the path where the OpenUI5 resources are located (typically globally under /resources or locally under resources).

Other development environments might need the resources to be copied to the server and referenced relatively to the app (see Standard Variant for Bootstrapping).

Alternatively, you can use the CDN version (see Variant for Bootstrapping from Content Delivery Network).

Console shows SyntaxError: <error details>

A JavaScript error in the application code throws an exception and stops all subsequent execution. Take a look at the error details: In most cases, the root cause is mentioned in the first line of the error message.

The stack trace can provide more context on the execution scope. Analyze it from thoroughly to find a line referencing your application code and start debugging there.

Console shows Error: Invalid XML

If the XML view to be displayed cannot be parsed, OpenUI5 stops the execution and throws a parse error. Check the XML view for namespace issues, typos, and missing closing tags. Do a schema validation with an XML validator tool.

Console shows Uncaught Error: failed to load 'sap/m/xxxxx.js'

During the development on Microsoft Windows, your app works fine, but a soon as you deploy it on a Linux system, only an empty page comes up.

This could happen if you wrote the tag of the control with lowercase letters, because Linux systems use case-sensitive file names.

Correct Example

Incorrect Example

<Button text="Click me" />

<button text="Click me" />

Error message: Uncaught Error: failed to load 'sap/m/button.js'

Tip:

Control tags always start with capital letters after the namespace like <Button>, <l:FixFlex>, <f:SimpleForm>.

Aggregations always start with lowercase letters like <content>, <l:fixContent>, <f:content>

Console shows no error

Your root view is missing a root control. In the context of OpenUI5, sap.m.App or sap.m.SplitApp function as root controls. Please check your root view (for example App.view.xml) and add the missing root control.