The gs Object: Every Method You Actually Use in ServiceNow Scripting

gs is the global server-side utility object available in Business Rules, Script Includes, Scheduled Jobs, and anywhere else server-side JavaScript runs. Here is a practical reference of the methods you will actually use.

Logging

gs.log('message');              // General log (System Log)
gs.info('message');             // Info level
gs.warn('message');             // Warning level  
gs.error('message');            // Error level
gs.debug('message');            // Debug — only shows if debug logging is on

User context

gs.getUserID();                 // sys_id of current user
gs.getUserName();               // username of current user
gs.getUser().getFullName();     // Display name
gs.hasRole('admin');            // Boolean - does current user have role?
gs.hasRole('itil,admin');       // Boolean - has any of these roles?
gs.getSession().getClientIP();  // Client IP address

Date and time

gs.now();                       // Current datetime as string (UTC)
gs.nowDateTime();               // GlideDateTime of current time
gs.beginningOfToday();          // Start of today
gs.endOfToday();                // End of today
gs.beginningOfLast7Days();      // 7 days ago
gs.beginningOfThisMonth();      // First day of this month

Formatting and utilities

gs.generateGUID();              // Generate a new sys_id
gs.urlDecode(str);              // URL decode
gs.xmlToJSON(xmlStr);           // Convert XML string to JS object
gs.base64Encode(str);           // Base64 encode
gs.base64Decode(str);           // Base64 decode

System properties

gs.getProperty('glide.ui.home');           // Get a system property value
gs.setProperty('my.prop', 'value');        // Set a system property
gs.getProperty('my.prop', 'defaultValue');// With fallback

Event management

gs.eventQueue('event.name', current, param1, param2);
gs.eventQueueScheduled('event.name', current, param1, param2, 'tomorrow');

Impersonation and session

gs.getSession().isInteractive();  // True if user is interacting (not API/background)
gs.isInteractive();               // Same as above, shorthand

Want the complete reference?

This article is part of the NowSpectrum knowledge library. Browse all products for cheat sheets, interview prep, and deep-dive reference guides.

Browse All Products →