Ethiris Admin Manual

Script-objektet

Script-objektet är ett hjälpobjekt. Objektet representerar skriptmotorn.

Egenskaper i Script-objektet

RetainVariables

Detta är en boolsk egenskap som bestämmer om lokala skriptobjekt ska behållas när serverkonfigurationen uppdateras. Som standard behålls inte lokala skriptobjekt.

Exempel:

Script.RetainVariables = true;

Event i Script-objektet

Det finns tre olika event som man kan fånga upp i sitt skript.

onEnter

Detta event är det första som sker när skript börjar köras, till exempel när servern startar upp, efter en konfigurationsuppdatering och när en medlem blir master i ett kluster.

Exempel:

Script.onEnter = function(event)
{
Debug.Print("Script.onEnter");
}

Exemplet kommer att skriva ut Script.onEnter när skriptet börjar köras.

Detta kan användas för att till exempel allokera resurser vid starten, i stället som för i tidigare versioner, nyttja en oinitierad variabel för detta syfte.

Exempel:

var init;
if(init == undefined)
{
var startTime = new Date();
init = true;
Debug.Print("Finished init");
}

onExit

Detta event är det sista som sker när skriptet slutar att köras, till exempel när servern stängs ner, precis innan en konfigurationsuppdatering och när en medlem slutar att vara master i ett kluster.

Exempel:

Script.onExit = function(event)
{
Debug.Print("Script.onExit");
}

Exemplet kommer att skriva ut Script.onExit när skriptet avslutas. Detta kan användas för att städa upp resurser innan skriptet avslutas.

onInit

Detta event sker efter att alla skriptbibliotek har initialiserats i samband med när skript börjar köras, till exempel när servern startar upp, efter en konfigurationsuppdatering och när en medlem blir master i ett kluster.

Exempel:

Script.onInit = function(event)
{
Debug.Print("Script.onInit");
}

Exemplet kommer att skriva ut Script.onInit när skriptet börjar köras och alla skriptbibliotek har initialiserats.

Detta kan användas för att till exempel allokera resurser vid starten, där någon av dessa finns definierade i skriptbibliotek, och dessa måste därför först vara laddade för att kunna nås från huvudskriptet.