How to use Toolbox, Toolbox erklärt.

function Main(){
  print("Hello Shelly World");
}


// Dekats Toolbox, a universal Toolbox for Shelly scripts
function Cut(f,k,o,i){ //Upgrade slice f=fullData, k=key-> where to cut, o=offset->offset behind key, i=invertCut
    try{
        let s= f.indexOf(k); if(s === -1) return; if(o) s= s+o.length || s+o; if(i) return f.slice(0,s); 
        return f.slice(s);}catch(e){ErrorMsg(e,'Cut()');}}
function Setup(){ //Wating 2sek, to avoid a Shelly FW Bug
    try{
        if(Main && !tH9){tH9= Timer.set(2000,0,function(){print('\nStatus: started Script _[', scriptN,']_');
        if(callLimit > 5){callLimit= 5;} try{Main();}catch(e){ErrorMsg(e,'Main()'); Setup();}});}}catch(e){ErrorMsg(e,'Setup()');}}
function ErrorMsg(e,s,deBug){ //Toolbox formatted Error Msg
     try{
         let i= 0; if(Cut(e.message, '-104: Timed out')) i= 'wrong URL or device may be offline';
         if(s === 'Main()' || deBug) i= e.stack; if(Cut(e.message, '"Main" is not')) i= 'define a Main() function before using Setup()';
         print('Error:',s || "",'---> ',e.type,e.message); if(i) print('Info: maybe -->',i);}catch(e){print('Error: ErrorMsg() --->',e);}}
var tH9= 0, callLimit= 4; //Toolbox global variable
var Status= Shelly.getComponentStatus, Config= Shelly.getComponentConfig; //Renamed native function 
var info= Shelly.getDeviceInfo(), scriptID= Shelly.getCurrentScriptId(), scriptN= Config('script',scriptID).name; //Pseudo const, variabel
//Toolbox v3.4 -Alpha(cut), Shelly FW >1.0.8
Setup();

function Main(){
  print("Hello Shelly World"äää);
}


// Dekats Toolbox, a universal Toolbox for Shelly scripts
function Cut(f,k,o,i){ //Upgrade slice f=fullData, k=key-> where to cut, o=offset->offset behind key, i=invertCut
    try{
        let s= f.indexOf(k); if(s === -1) return; if(o) s= s+o.length || s+o; if(i) return f.slice(0,s); 
        return f.slice(s);}catch(e){ErrorMsg(e,'Cut()');}}
function Setup(){ //Wating 2sek, to avoid a Shelly FW Bug
    try{
        if(Main && !tH9){tH9= Timer.set(2000,0,function(){print('\nStatus: started Script _[', scriptN,']_');
        if(callLimit > 5){callLimit= 5;} try{Main();}catch(e){ErrorMsg(e,'Main()'); Setup();}});}}catch(e){ErrorMsg(e,'Setup()');}}
function ErrorMsg(e,s,deBug){ //Toolbox formatted Error Msg
     try{
         let i= 0; if(Cut(e.message, '-104: Timed out')) i= 'wrong URL or device may be offline';
         if(s === 'Main()' || deBug) i= e.stack; if(Cut(e.message, '"Main" is not')) i= 'define a Main() function before using Setup()';
         print('Error:',s || "",'---> ',e.type,e.message); if(i) print('Info: maybe -->',i);}catch(e){print('Error: ErrorMsg() --->',e);}}
var tH9= 0, callLimit= 4; //Toolbox global variable
var Status= Shelly.getComponentStatus, Config= Shelly.getComponentConfig; //Renamed native function 
var info= Shelly.getDeviceInfo(), scriptID= Shelly.getCurrentScriptId(), scriptN= Config('script',scriptID).name; //Pseudo const, variabel
//Toolbox v3.4 -Alpha(cut), Shelly FW >1.0.8
Setup();

function Main(){
    print("Hello Setup() World");
}
// Dekats Toolbox, a universal Toolbox for Shelly scripts
function Cut(f,k,o,i){ //Upgrade slice f=fullData, k=key-> where to cut, o=offset->offset behind key, i=invertCut
    try{
        let s= f.indexOf(k); if(s === -1) return; if(o) s= s+o.length || s+o; if(i) return f.slice(0,s); 
        return f.slice(s);}catch(e){ErrorMsg(e,'Cut()');}}
function Setup(){ //Waiting 2 seconds to avoid a Shelly FW Bug
    try{ //Try-catch to catch the "no Main defined" error
        if(Main && !tH9){ //Check for Main and if it has already been called
            tH9= Timer.set(2000, 0, function(){ //Create 2seconds Timer with unnamed function and set global Timer Handler(tH9)
                print('\nStatus: started Script _[', scriptN,']_'); //Print start status with script name
                if(callLimit > 5) callLimit = 5; //Check if callLimit is valid and set it to 5 if not
                try{ //Try-catch to catch errors inside Main()
                    Main(); //Execute Main()
                }catch(e){ //Catch Main() error object
                    ErrorMsg(e, 'Main()'); //Call ErrorMsg() with the caught error object and an additional error title string
                    tH9= 0; //Reset Timer Handler, its not null after it got cleared so a reset is needed
                    Setup(); //Call Setup() again
                }
            });
        }
    }catch(e){ //Catch Setup() error object
        ErrorMsg(e, 'Setup()'); //Call ErrorMsg() with the caught error object and an additional error title string
    }
}
function ErrorMsg(e,s,deBug){ //Toolbox formatted Error Msg
     try{
         let i= 0; if(Cut(e.message, '-104: Timed out')) i= 'wrong URL or device may be offline';
         if(s === 'Main()' || deBug) i= e.stack; if(Cut(e.message, '"Main" is not')) i= 'define a Main() function before using Setup()';
         print('Error:',s || "",'---> ',e.type,e.message); if(i) print('Info: maybe -->',i);}catch(e){print('Error: ErrorMsg() --->',e);}}
var tH9= 0, callLimit= 5; //Toolbox global variable
var Status= Shelly.getComponentStatus, Config= Shelly.getComponentConfig; //Renamed native function 
var info= Shelly.getDeviceInfo(), scriptID= Shelly.getCurrentScriptId(), scriptN= Config('script',scriptID).name; //Pseudo const, variabel
//Toolbox v3.5-Alpha(cut), Shelly FW >1.0.8
Setup(); //Execute Setup()

function Beispiel_0(){
    try{
        print("Hello ErrorMsg() World");
    }catch(e){ErrorMsg(e,"Beispiel_0()");}
}

function Main(){  
    Timer.set(3000,1,Beispiel_0);
}

// Dekats Toolbox, a universal Toolbox for Shelly scripts
function Cut(f,k,o,i){ //Upgrade slice f=fullData, k=key-> where to cut, o=offset->offset behind key, i=invertCut
    try{
        let s= f.indexOf(k); if(s === -1) return; if(o) s= s+o.length || s+o; if(i) return f.slice(0,s); 
        return f.slice(s);}catch(e){ErrorMsg(e,'Cut()');}}
function Setup(){ //Wating 2sek, to avoid a Shelly FW Bug
    try{
        if(Main && !tH9){tH9= Timer.set(2000,0,function(){print('\nStatus: started Script _[', scriptN,']_');
        if(callLimit > 5){callLimit= 5;} try{Main();}catch(e){ErrorMsg(e,'Main()'); tH9= 0; Setup();}});}}catch(e){ErrorMsg(e,'Setup()');}}
function ErrorMsg(e,s,deBug){ //Toolbox formatted Error Msg
     try{
         let i= 0; //Define info Variabel
         if(Cut(e.message, '-104: Timed out')) i= 'wrong URL or device may be offline'; //Search for "-104: Timed out" Error Msg, and add info to it
         if(s === 'Main()' || deBug) i= e.stack; //Add Extra Error Information if inside Main loop or deBug is true. 
         if(Cut(e.message, '"Main" is not')) i= 'define a Main() function before using Setup()'; //Search for ""Main" is not'", and show No Main() function found Info
         print('Error:',s || "",'---> ',e.type,e.message);  //Print formatted error output and add error title string
         if(i) print('Info: maybe -->',i); //Print the Info String if it exists.
     }catch(e){
         print('Error: ErrorMsg() --->',e);} //Just print Error Objekt if there is an Error inside ErrorMsg()
     }
var tH8= 0, tH9= 0, aC= 0, cCache= [], nCall= [], callLimit= 5, cacheLimit= 40, cSp= 0.1; //Toolbox global variable
var Status= Shelly.getComponentStatus, Config= Shelly.getComponentConfig; //Renamed native function 
var info= Shelly.getDeviceInfo(), scriptID= Shelly.getCurrentScriptId(), scriptN= Config('script',scriptID).name; //Pseudo const, variabel
//Toolbox v3.5 -Alpha(cut), Shelly FW >1.0.8
Setup();

let debug= false; //Debug Flag
function Beispiel_3(){
    try{
        print("Hello ErrorMsg() World");
        throw new Error("Cheesecake!"); //Erzeuge Fehler
        print("The End");
    }catch(e){ErrorMsg(e,"Beispiel_3()",debug);}
}

function Main(){  
    Timer.set(3000,1,Beispiel_3);
}

// Dekats Toolbox, a universal Toolbox for Shelly scripts
function Cut(f,k,o,i){ //Upgrade slice f=fullData, k=key-> where to cut, o=offset->offset behind key, i=invertCut
    try{
        let s= f.indexOf(k); if(s === -1) return; if(o) s= s+o.length || s+o; if(i) return f.slice(0,s); 
        return f.slice(s);}catch(e){ErrorMsg(e,'Cut()');}}
function Setup(){ //Wating 2sek, to avoid a Shelly FW Bug
    try{
        if(Main && !tH9){tH9= Timer.set(2000,0,function(){print('\nStatus: started Script _[', scriptN,']_');
        if(callLimit > 5){callLimit= 5;} try{Main();}catch(e){ErrorMsg(e,'Main()'); tH9= 0; Setup();}});}}catch(e){ErrorMsg(e,'Setup()');}}
function ErrorMsg(e,s,deBug){ //Toolbox formatted Error Msg
     try{
         let i= 0; //Define info Variabel
         if(Cut(e.message, 'cake')) i= 'cake refers to a sweet baked dessert typically made from a mixture of flour, sugar, eggs, and butter, often with additional ingredients such as chocolate, fruits, or nuts.';
         if(Cut(e.message, '-104: Timed out')) i= 'wrong URL or device may be offline'; //Search for "-104: Timed out" Error Msg, and add info to it
         if(s === 'Main()' || deBug) i= e.stack; //Add Extra Error Information if inside Main loop or deBug is true. 
         if(Cut(e.message, '"Main" is not')) i= 'define a Main() function before using Setup()'; //Search for ""Main" is not'", and show No Main() function found Info
         print('Error:',s || "",'---> ',e.type,e.message);  //Print formatted error output and add error title string
         if(i) print('Info: maybe -->',i); //Print the Info String if it exists.
     }catch(e){
         print('Error: ErrorMsg() --->',e);} //Just print Error Objekt if there is an Error inside ErrorMsg()
     }
var tH8= 0, tH9= 0, aC= 0, cCache= [], nCall= [], callLimit= 5, cacheLimit= 40, cSp= 0.1; //Toolbox global variable
var Status= Shelly.getComponentStatus, Config= Shelly.getComponentConfig; //Renamed native function 
var info= Shelly.getDeviceInfo(), scriptID= Shelly.getCurrentScriptId(), scriptN= Config('script',scriptID).name; //Pseudo const, variabel
//Toolbox v3.5 -Alpha(cut), Shelly FW >1.0.8
Setup();

function Main() {
  print(Cut("ShellShellySellerie","Shelly","Shelly"));
}

// Dekats Toolbox, a universal Toolbox for Shelly scripts
function Cut(f,k,o,i){ //Upgrade slice f=fullData, k=key-> where to cut, o=offset->offset behind key, i=invertCut
    try{
        let s= f.indexOf(k); //Search for index(s) of key(k) in fullData(f)
        if(s === -1) return null;  //Exit if no key(k) found in fullData(f) and return null
        if(o) s= s+o.length || s+o; //If 0ffset(o) is truthy, check if o has .length to use it as offset, if no .length available, just use o as offset
                                    //Also if 0ffset(o) add o to index s
        if(i) return f.slice(0,s);  //If invertedCut(i) is truthy, do an inverted cut on data f before index s+offset o, return what got cut out of data f 
        return f.slice(s); //do a cut on data f at index s+offset o, return what got cut out of data f
    }catch(e){
        ErrorMsg(e,'Cut()'); //Error Handling, print Error Msg, trough the ErrorMsg() tool
    }
}
function Setup(){ //Wating 2sek, to avoid a Shelly FW Bug
    try{
        if(Main && !tH9){tH9= Timer.set(2000,0,function(){print('\nStatus: started Script _[', scriptN,']_');
        if(callLimit > 5){callLimit= 5;} try{Main();}catch(e){ErrorMsg(e,'Main()'); tH9= 0; Setup();}});}}catch(e){ErrorMsg(e,'Setup()');}}
function ErrorMsg(e,s,deBug){ //Toolbox formatted Error Msg
     try{
         let i= 0; if(Cut(e.message, '-104: Timed out')) i= 'wrong URL or device may be offline';
         if(s === 'Main()' || deBug) i= e.stack; if(Cut(e.message, '"Main" is not')) i= 'define a Main() function before using Setup()';
         print('Error:',s || "",'---> ',e.type,e.message); if(i) print('Info: maybe -->',i);}catch(e){print('Error: ErrorMsg() --->',e);}}
var tH8= 0, tH9= 0, aC= 0, cCache= [], nCall= [], callLimit= 5, cacheLimit= 40, cSp= 0.1; //Toolbox global variable
var Status= Shelly.getComponentStatus, Config= Shelly.getComponentConfig; //Renamed native function 
var info= Shelly.getDeviceInfo(), scriptID= Shelly.getCurrentScriptId(), scriptN= Config('script',scriptID).name; //Pseudo const, variabel
//Toolbox v3.6 -Alpha(cut), Shelly FW >1.0.8
Setup();

let some_String_Data= "Hello cut World";
let some_Array_Data= ["a","4",4,4,"e"];
function Main() {
  print(Cut("ShellShellySellerie","Shelly","Shelly"));
  print("--Beispiel_0-->",Cut(some_String_Data, "cut"));
  print("--Beispiel_1-->",Cut(some_String_Data, "Hallo"));
  print("--Beispiel_2-->",Cut(some_Array_Data, 3));
  print("--Beispiel_3-->",Cut(some_Array_Data, 4));
  print("--Beispiel_4-->",Cut(some_String_Data, "cut", "cut"));
  print("--Beispiel_5-->",Cut(some_String_Data, "cut", -30));
  print("--Beispiel_6-->",Cut(some_Array_Data, 4, "cut"));
  print("--Beispiel_7-->",Cut(some_Array_Data, 4, -30));
  print("--Beispiel_8-->",Cut(some_String_Data, "cut", "cut", 1));
  print("--Beispiel_9-->",Cut(some_String_Data, "cut", 0, true));
  print("--Beispiel_10-->",Cut(some_Array_Data, 4, null, -1));
  if(Cut(some_String_Data, "cut")) print("--Beispiel_11--> ","Yes it can filter Strings!");
  if(!Cut(some_String_Data,"Hallo")) print("--Beispiel_12--> ","No match, found!");
  if(Cut(some_Array_Data,"e")) print("--Beispiel_13--> ","Yes it can filter Arrays!");
  if(!Cut(some_Array_Data,3)) print("--Beispiel_14--> ","No match, found!");
}

// Dekats Toolbox, a universal Toolbox for Shelly scripts
function Cut(f,k,o,i){ //Upgrade slice f=fullData, k=key-> where to cut, o=offset->offset behind key, i=invertCut
    try{
        let s= f.indexOf(k); //Search for index(s) of key(k) in fullData(f)
        if(s === -1) return null;  //Exit if no key(k) found in fullData(f) and return null
        if(o) s= s+o.length || s+o; /*If 0ffset(o) is truthy, check if o has .length to use it as offset, if no .length available, just use o as offset
                                      also if 0ffset(o) add o to index s */
        if(i) return f.slice(0,s);  //If invertedCut(i) is truthy, do an inverted cut on data f before index s+offset o, return what got cut out of data f 
        return f.slice(s); //do a cut on data f at index s+offset o, return what got cut out of data f
    }catch(e){
        ErrorMsg(e,'Cut()'); //Error Handling, print Error Msg, trough the ErrorMsg() tool
    }
}
function Setup(){ //Wating 2sek, to avoid a Shelly FW Bug
    try{
        if(Main && !tH9){tH9= Timer.set(2000,0,function(){print('\nStatus: started Script _[', scriptN,']_');
        if(callLimit > 5){callLimit= 5;} try{Main();}catch(e){ErrorMsg(e,'Main()'); tH9= 0; Setup();}});}}catch(e){ErrorMsg(e,'Setup()');}}
function ErrorMsg(e,s,deBug){ //Toolbox formatted Error Msg
     try{
         let i= 0; if(Cut(e.message, '-104: Timed out')) i= 'wrong URL or device may be offline';
         if(s === 'Main()' || deBug) i= e.stack; if(Cut(e.message, '"Main" is not')) i= 'define a Main() function before using Setup()';
         print('Error:',s || "",'---> ',e.type,e.message); if(i) print('Info: maybe -->',i);}catch(e){print('Error: ErrorMsg() --->',e);}}
var tH8= 0, tH9= 0, aC= 0, cCache= [], nCall= [], callLimit= 5, cacheLimit= 40, cSp= 0.1; //Toolbox global variable
var Status= Shelly.getComponentStatus, Config= Shelly.getComponentConfig; //Renamed native function 
var info= Shelly.getDeviceInfo(), scriptID= Shelly.getCurrentScriptId(), scriptN= Config('script',scriptID).name; //Pseudo const, variabel
//Toolbox v3.6 -Alpha(cut), Shelly FW >1.0.8
Setup();