Creating and Using a JavaScript File in Oracle APEX

In Oracle APEX, JavaScript files can be stored as Static Application Files and reused across multiple pages. This approach helps organize code, improve maintainability, and keep page-level JavaScript clean and reusable.

1. Open the Application

Start by opening the target Oracle APEX application from App Builder.

From the application home page, you will see the available pages, such as:

• Global Page
• Home Page
• Login Page

Next, navigate to the shared application components.

2. Open Shared Components

From the application home page, click Shared Components.

This section contains all reusable components and configurations used throughout the application, including security settings, navigation components, themes, and static files.

3. Navigate to Static Application Files

Inside Shared Components, locate the Files and Reports section and click:

Static Application Files

This area is used to store application-level resources such as:

• JavaScript files
• CSS files
• Images
• Icons

4. Create a New File

On the Static Application Files page, click:

Create File

This option allows you to create and manage files directly within the application.

5. Define the File Name and Directory

When creating the file, enter the following information:

Directory:

test

File Name:

test.js

Then click:

Create

to generate the JavaScript file.

6. Copy the File Reference

After creating the file, Oracle APEX displays the file details, including the Reference value.

Example:

#APP_FILES#test/test#MIN#.js

This reference is used whenever the JavaScript file needs to be loaded within the application.

Note: The #MIN# placeholder allows Oracle APEX to automatically use the minified version of the file when available, improving application performance.

7. Include the JavaScript File in a Page

Open the page where the JavaScript file should be loaded.

In the page properties panel, navigate to:

JavaScript → File URLs

Add the file reference:

#APP_FILES#test/test#MIN#.js

If multiple JavaScript files are required, add each file on a separate line.

After adding the reference, save the page and run the application.

Benefits of Using Static JavaScript Files

Using Static Application Files provides several advantages:

• Centralized JavaScript management.
• Reusable code across multiple pages.
• Easier maintenance and updates.
• Improved page readability.
• Better performance through support for minified files.

By storing JavaScript files as Static Application Files and referencing them through the File URLs property, developers can build cleaner, more scalable, and easier-to-maintain Oracle APEX applications.

Conclusion

Managing JavaScript files through Static Application Files in Oracle APEX is a practical and efficient approach for organizing client-side code. Instead of embedding JavaScript directly within individual pages, developers can create reusable files that can be referenced across multiple pages, resulting in cleaner, more maintainable applications.

By following the steps outlined in this guide — creating a JavaScript file, obtaining its reference path, and loading it through the page’s File URLs property — you can simplify code management, improve application structure, and enhance overall development efficiency. This approach becomes especially valuable in large-scale Oracle APEX applications where code reusability and maintainability are essential.