Create and use JavaScript modules in applications in the ServiceNow IDE
Optimize your codebase by defining reusable code blocks with JavaScript modules in the ServiceNow IDE.
Before you begin
Create, convert, or clone an application and add it to your workspace. For more information, see Adding applications in ServiceNow IDE.
Note: To use TypeScript in modules, select TypeScript as the template type when creating an application.
Role required: admin
About this task
To learn about support for using JavaScript modules in scoped applications, including some limitations, see JavaScript modules and third-party libraries. For general information about the syntax used to create JavaScript modules, see the JavaScript modules page on the MDN Web Docs website.
Note: With Now Assist for Code, you can use the Code autocomplete skill to generate code suggestions for module scripts. For more information, see Generate code with autocomplete.
Procedure
Navigate to All > App Development > ServiceNow IDE.
Open a workspace with an application.
From the Activity Bar, select the File Explorer view (
File Explorer\).
In the
src/serverdirectory of the application, create a JavaScript or TypeScript file to contain the module code you want to reuse.Import server APIs or script includes to call them from your module.
Glide APIs can be imported from the
@servicenow/glidepackage or their namespace in the package. Script includes can be imported from their application scope or the global scope in the@servicenow/glidepackage.For example:
import { API } from "@servicenow/glide"; import { API } from "@servicenow/glide/<namespace>"; import { ScriptInclude } from "@servicenow/glide/<scope>"; import { global } from "@servicenow/glide/global";In the module, identify the code to export with export statements.
You can use a named export or default export. Named exports can be variables, constants, functions, or classes whereas default exports can be functions or classes only.
The following example is one way of adding a named export for multiple features (a function and a variable) in a module:
export { myFunction, myVariable };Use code from the exported module in other modules or server-side scripts.
| File | Steps |
|---|---|
| Module |
The following example is one way that you could import an exported feature in a module: Note: To import code from one TypeScript file to another TypeScript file, you must include the
|
| Server-side script in source code | 1. Create or open the definition of application metadata that includes a server-side script, such as a business rule, in source code \(`.now.ts` file\). 2. In the script property, import and call the module code to reuse it. You can import a function or provide an inline script. - Import an exported function, function expression, or default function. For example: ```javascript script: FunctionExport, ``` - Inline scripts must use require statements to import the module code. For example: ```javascript script: ` const { process } = require('./dist/modules/server/handler.js') process(request, response)`, ``` For more information about server-side scripts in source code, see ServiceNow Fluent API reference. |
| Server-side script record | 1. Open the record for a server-side script, such as a business rule. 2. Import the module code with require statements. The following example is one way that you could import an exported feature in a script: ```javascript const { feature } = require("path/to/module"); ``` 3. Call the module code from this script to reuse it. |
Save your changes.
From the Status Bar, select Build and Install.
Build and deploy
The active file that's open in the editor determines which application to build. If no files are open, select the application to build when prompted.
After building, the modules are added to the EcmaScript Module \[sys\_module\] table.
What to do next
To use third-party libraries in a JavaScript module, see Use third-party libraries in applications in the ServiceNow IDE.
Parent Topic:Developing applications with the ServiceNow IDE
Related topics