Create and use JavaScript modules in applications with the ServiceNow SDK
Optimize your codebase by defining reusable code blocks with JavaScript modules and the ServiceNow SDK.
Before you begin
Add an application to your local system with the ServiceNow SDK. For more information, see Adding applications with the ServiceNow SDK.
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.
Procedure
In Visual Studio Code, open your scoped application directory.
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.
What to do next
To use third-party libraries in a JavaScript module, see Use third-party libraries in applications with the ServiceNow SDK.
To build your application and add the modules to the EcmaScript Module [sys_module] table, see Build and install an application with the ServiceNow SDK.
- Using TypeScript in JavaScript modules with the ServiceNow SDK
Use TypeScript when creating JavaScript modules with the ServiceNow SDK.
Parent Topic:Developing applications with the ServiceNow SDK
Related topics