Global functions

Availability

Flash Communication Server 1

Parameters

intervalID

An identifier that contains the value returned by a previous call to the setInterval() method.

Example

The following example creates a function named callback() and passes it to the setInterval() method, which is called every 1000 milliseconds and outputs the message "interval called." The setInterval() method returns a number that is assigned to the intervalID variable. The identifier lets you cancel a specific setInterval() call. In the last line of code, the intervalID variable is passed to the clearInterval() method to cancel the setInterval() call.

function callback(){trace("interval called");} 
var intervalID;  
intervalID = setInterval(callback, 1000);  
// sometime later  
clearInterval(intervalID);

Availability

Flash Media Server 2

Details

Flash Media Interactive Server has two script execution modes: secure and normal. In secure mode, only the secure.asc file (if it exists) is loaded and evaluated—no other application scripts are loaded. The getGlobal() and protectObject() functions are available only in secure mode. These functions are very powerful because they provide complete access to the script execution environment and let you create system objects. Once the secure.asc file is loaded, the server switches to normal script execution mode until the application is unloaded.

To prevent inadvertent access to the global object, always hold its reference in a temporary variable (declared by var); do not hold its reference in a member variable or a global variable.

Example

The following code gets a reference to the global object:

var global = getGlobal();

Availability

Flash Communication Server 1

Parameters

filename

A string indicating the relative path to a script file from the main.asc file.

Example

The following example loads the myLoadedFile.asc file:

load("myLoadedFile.asc");

Availability

Flash Media Server 2

Parameters

object

An object to protect.

Returns

An Object.

Details

After an object is protected, don’t reference it in global variables or make it a member of an accessible object. The object returned by protectObject() dispatches all method invocations to the underlying object but blocks access to member data. As a result, you can’t enumerate or modify members directly. The protected object keeps an outstanding reference to the underlying object, which ensures that the object is valid. The protected object follows normal reference rules and exists while it is referred to.

Flash Media Interactive Server has two script execution modes: secure and normal. In secure mode, only the secure.asc file (if it exists) is loaded and evaluated—no other application scripts are loaded. The getGlobal() and protectObject() functions are available only in secure mode. These functions are very powerful because they provide complete access to the script execution environment and let you create system objects. Once the secure.asc file is loaded, the server switches to normal script execution mode until the application is unloaded.

Example

After secure.asc is executed, calls to load() are directed through the user-defined system call, as shown in the following example:

var sysobj = {}; 
sysobj._load = load; // Hide the load function 
load = null; // Make it unavailable unpriviliged code. 
sysobj.load = function(fname){ 
    // User-defined code to validate/modify fname 
    return this._load(fname); 
} 
// Grab the global object. 
var global = getGlobal(); 
 
// Now protect sysobj and make it available as 
// "system" globally. Also, set its attributes 
// so that it is read-only and not deletable. 
 
global["system"] = protectObject(sysobj); 
 
setAttributes(global, "system", false, true, true); 
 
// Now add a global load() function for compatibility. 
// Make it read-only and nondeletable. 
 
global["load"] = function(path){ 
    return system.load(path); 
} 
 
setAttributes(global, "load", false, true, true);

See also

LoadVars class

Availability

Flash Media Server 2

Parameters

object

An Object.

propName  A string indicating the name of the property in the object parameter. Setting attributes on nonexistent properties has no effect.

enumerable

One of the following values: true, false, or null. Makes a property enumerable if true or nonenumerable if false; a null value leaves this attribute unchanged. Nonenumerable properties are hidden from enumerations (forvariinobj).

readonly

One of the following values: true, false, or null. Makes a property read-only if true or writable if false; a null value leaves this attribute unchanged. Any attempt to assign a new value is ignored. Typically, you assign a value to a property while the property is writable and then make the property read-only.

permanent

One of the following values: true, false, or null. Makes a property permanent (nondeletable) if true or deletable if false; a null value leaves this attribute unchanged. Any attempt to delete a permanent property (by calling deleteobj.prop) is ignored.

Example

The following code prevents the resolve() method from appearing in enumerations:

Object.prototype.__resolve = function(methodName){ ... }; 
setAttributes(Object.prototype, "__resolve", false, null, null);

The following example creates three constants on a Constants object and makes them permanent and read-only:

Constants.KILO = 1000;  
setAttributes(Constants, "KILO", null, true, true); 
Constants.MEGA = 1000*Constants.KILO;  
setAttributes(Constants, "MEGA", null, true, true); 
Constants.GIGA = 1000*Constants.MEGA; setAttributes(Constants, "GIGA", null, true, true);

Availability

Flash Communication Server 1

Parameters

function

A Function object.

object.method

A method to call on object.

interval

A number indicating the time in milliseconds between calls to function.

p1, ..., pN

Optional parameters passed to function.

Returns

An integer that provides a unique ID for this call. If the interval is not set, returns -1.

Example

The following example uses an anonymous function to send the message "interval called" to the server log every second:

setInterval(function(){trace("interval called");}, 1000);

The following example also uses an anonymous function to send the message “interval called” to the server log every second, but it passes the message to the function as a parameter:

setInterval(function(s){trace(s);}, 1000, "interval called");

The following example uses a named function, callback1(), to send the message "interval called" to the server log:

function callback1(){trace("interval called"); } 
setInterval(callback1, 1000); 

The following example also uses a named function, callback2(), to send the message "interval called" to the server log, but it passes the message to the function as a parameter:

function callback2(s){ 
    trace(s); 
} 
setInterval(callback2, 1000, "interval called");

The following example uses the second syntax:

var a = new Object(); 
a.displaying=displaying; 
setInterval(a.displaying, 3000); 
 
displaying = function(){ 
    trace("Hello World"); 
}

The previous example calls the displaying() method every 3 seconds and sends the message "Hello World" to the server log.

See also

clearInterval()

Availability

Flash Communication Server 1

Parameters

expression

Any valid expression. The values in expression are converted to strings if possible.