Splunk.Context
Important notice: As part of Advanced XML deprecation, the Module System is officially deprecated beginning with Splunk Enterprise 6.3. For more information, see Advanced XML Deprecation. |
clone()
The clone() method gets an exact copy of a module context.
Synopsis
contextCopy = someContext.clone()
Return Value
Object | Duplicate of the current context object. |
Example
dupCurrentContext: function() {
var context = this.getContext()
return = context.clone();
}
enforceByValue()
The enforceByValue() method ensures that the get() and getAll() methods return objects by value instead of by reference.
Note: This method usually does not need to be called because the getter and setter methods already enforce return by-value.
Synopsis
eValue = enforceByValue( value )
Parameters
value | Object | Value to be checked for references. |
Return Value
Object | Enforced value. |
See Also
get()
The get() method is a generic getter that gets the value associated with the named key, provided the key is defined for the context. A context is a user-defined dictionary of name-value pairs.
Synopsis
value = get( name )
Parameters
name | String | Context dictionary key. |
Return Value
Object | Value corresponding to the name key. If name does not exist, the method returns null. Note that this method returns a value and not a reference. |
Example
getSearch: function() {
var context = this.getContext()
return context.get('search');
}
See Also
enforceByValue()
getAll()
set()
getAll()
The getAll() method is a generic getter that gets all values at or below the name namespace.
For example, given charting.chart.stackMode and charting.chart keys, calling getAll("charting") returns a map of hash values for the chart.stackMode and chart keys.
Synopsis
hash = getAll( name )
Parameters
name | String | key name for which the corresponding values are returned. |
Return Value
Object | List of corresponding values at or below the name key. If name had no matching values, null is returned. Note that this method returns values and not a references to the values. |
Example
getResultsDict: function() {
var context = this.getContext()
return context.getAll("results");
}
See Also
has()
The has() method checks if the context contains the name key.
Synopsis
status = has( name )
Parameters
name | String | Key name to test. |
Return Value
Boolean | Requested name key found indication: true = Key with specified name exists. false = Key with specified name does not exist. |
Example
hasSearch: function() {
var context = this.getContext();
if (context.has("search")) {
return true;
else
return false;
}
}
set()
The set() method is a generic setter that stores the specified name - value pair, by value, in the context.
The method never assigns a reference value but copies the referenced object.
Synopsis
set( name, value)
Parameters
name | String | Key name to associate with value. |
value | Object | Value to be set for key name. Note that this method overwrites the current value if name already exists. |
Example
setBaseSearch: function(baseSearch) {
var context = this.getContext();
var search = context.get('search');
search.setBaseSearch(baseSearch);
context.set('search', search);
}
See Also
Extension dictionary | Splunk.Job |
This documentation applies to the following versions of Splunk® Enterprise: 7.0.0, 7.0.1, 7.0.2, 7.0.3, 7.0.4, 7.0.5, 7.0.6, 7.0.7, 7.0.8, 7.0.9, 7.0.10, 7.0.11, 7.0.13, 7.1.0, 7.1.1, 7.1.2, 7.1.3, 7.1.4, 7.1.5, 7.1.6, 7.1.7, 7.1.8, 7.1.9, 7.1.10, 7.2.0, 7.2.1, 7.2.2, 7.2.3, 7.2.4, 7.2.5, 7.2.6, 7.2.7, 7.2.8, 7.2.9, 7.2.10, 7.3.0, 7.3.1, 7.3.2, 7.3.3, 7.3.4, 7.3.5, 7.3.6, 7.3.7, 7.3.8, 7.3.9
Feedback submitted, thanks!