Creazione di test nei linguaggi di scripting

Oltre a C++ e C#, TAEF supporta la creazione di test nei linguaggi di scripting.

È possibile creare componenti di script usando qualsiasi linguaggio di scripting che supporti le interfacce di scripting COM Microsoft. I linguaggi di script che supportano queste interfacce includono JScript, Microsoft Visual Basic Scripting Edition (VBScript), PERLScript, PScript, Ruby e Python.

Limitazioni correnti della creazione di test script

Windows supporta solo JScript e VBScript.

Formato file di test script

Per i test del linguaggio di script, TAEF usa un formato di file windows Script Components leggermente modificato. Gli esempi seguenti illustrano un file di test che contiene classi di test VBScript e JScript.

1   <?xml version="1.0" ?>
2
3   <!-- Debugging helpers -->
4   <!-- error    Set this to true to display detailed error messages for syntax or run-time errors in the script component.-->
5   <!-- debug    Set this to true to enable debugging. If this debugging is not enabled, you cannot launch the script debugger for a script -->
6   <?component error="true" debug="true"?>
7
8   <package>
9       <!-- Test module metadata -->
10      <ModuleProperty name="Owner" value="Someone"/>
11
12      <!-- Define a test class -->
13      <component id="VBSampleTests">
14          <!-- define and instantiate a logger -->
15          <object id="Log" progid="WEX.Logger.Log" />
16  
17          <!-- include a reference to the logger so you could use the constants defined in logger library -->
18          <reference guid="e65ef678-a232-42a7-8a36-63108d719f31" version="1.0"/>
19
20          <!-- Test class metadata -->
21          <TestClassProperty name="DocumentationUrl" value="http://shelltestkb/"/>
22
23          <public>
24              <!-- Define a test method with metadata -->
25              <method name="TestOne">
26                  <!-- Test method metadata -->
27                  <TestMethodProperty name="Priority" value="1"/>
28              </method>
29  
30              <!-- Define a test method without metadata -->
31              <method name="TestTwo"/>
32         </public>
33
34          <script language="VBScript">
35              <![CDATA[
36                  Function TestOne()
37                      Log.Comment("Calling TestOne")
38                  End Function
39
40                  Function TestTwo()
41                      Log.Comment("Calling TestTwo")
42                  End Function
43              ]] >
44          </script>
45      </component>
46
47      <!-- Define another test class -->
48      <component id="JScriptSampleTests">
49          <object id="Log" progid="WEX.Logger.Log" />
50
51          <!-- need reference to use logger constants -->
52          <reference guid="e65ef678-a232-42a7-8a36-63108d719f31" version="1.0"/>
53
54          <public>
55              <!-- Test setup and cleanup methods are declared using corresponding type = '' attributes -->
56              <method name="ClassSetup" type="TestClassSetup"/>
57              <method name="ClassCleanup" type="TestClassCleanup"/>
58              <method name="MethodSetup"  type="TestMethodSetup"/>
59              <method name="MethodCleanup" type="TestMethodCleanup"/>
60
61              <method name="TestOne"/>
62              <method name="TestTwo"/>
63          </public>
64
65          <!-- Setup and Cleanup methods return false on failure -->
66          <script language="JScript">
67              <![CDATA[
68                  function ClassSetup()
69                  {
70                      Log.Comment("Calling class setup");
71                      return true;
72                  }
73
74                  function ClassCleanup()
75                  {
76                      Log.Comment("Calling class cleanup");
77                      return true;
78                  }
79
80                  function MethodSetup()
81                  {
82                      Log.Comment("Calling method setup");
83                      return true;
84                  }
85
86                  function MethodCleanup()
87                  {
88                      Log.Comment("Calling method cleanup");
89                      return true;
90                  }
91
92                  function TestOne()
93                  {
94                      Log.Comment("Calling TestOne");
95  
96                      // For the purpose of demonstration, declare the test failed
97                      Log.Result(TestResult_Failed);
98                  }
99
100                 function TestTwo()
101                 {
102                     Log.Comment("Calling TestTwo");
103                 }
104             ]] >
105         </script>
106     </component>
107 </package>

Questo esempio è un file XML e inizia con un'intestazione XML normale:

<?xml version="1.0" ?>

Per configurare le impostazioni di debug del file, imposta gli attributi errore e debug:

<?component error="true" debug="true"?>

• Impostare errore su vero per visualizzare messaggi di errore dettagliati relativi alla sintassi o agli errori di run-time nel componente script.
• Impostare debugsu true per abilitare il debug. Se il debug non è abilitato, non è possibile avviare il debugger di script per uno script, ad esempio con la parola chiave debug all'interno del codice JScript.

L'elemento <del pacchetto> racchiude le definizioni della classe di test in un file con estensione wsc . Dopo questo elemento, è possibile inserire metadati a livello di modulo aggiungendo gli elementi ModuleProperty :

<ModuleProperty name = "Owner" value = "Someone"/>

L'elemento ModuleProperty deve includere gli attributi nome e valore .

L'elemento Component avvia la dichiarazione per la classe di test dello script. Questo elemento deve avere sempre un attributo ID impostato sul nome della classe.

Dopo l'elemento Component , è possibile inserire metadati a livello di classe usando l'elemento TestClassProperty . Come per l'elemento ModuleProperty , deve avere gli attributi nome e valore .

A questo punto, è anche possibile creare oggetti e definire riferimenti agli oggetti . Per altre informazioni, vedere la sezione Altri componenti . Le righe 15, 18, 49 e 52 nell'esempio XML mostrano come fare riferimento e inizializzare l'oggetto WEX.Logger.Log.

L'elemento <pubblico> racchiude le dichiarazioni del metodo di test del modulo di test. Per dichiarare un metodo di test, specificare il nome del metodo di test nell'attributo name di un <elemento del metodo> . È possibile aggiungere la proprietà del metodo di prova all'interno dell'elemento <metodo>. Come per le proprietà ad altri livelli, non è obbligatorio. Tuttavia, se lo si aggiunge, è necessario includere gli attributi nome e valore .

L'elemento <script> identifica il linguaggio di script di test e racchiude l'implementazione dei metodi di test.

!<[ La sezione CDATA[]]> contiene l'implementazione effettiva dei test, ovvero il codice scritto nel linguaggio di scripting. In questa sezione vengono implementati i metodi di test dichiarati nella <sezione public></public> .