Skip to main content
summaryrefslogtreecommitdiffstats
blob: 7843bdaffb8aaa79feffb63f5b543b3d4dafff09 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
<!-- 
  Copyright (c) 2014 BREDEX GmbH.
  All rights reserved. This program and the accompanying materials
  are made available under the terms of the Eclipse Public License v1.0
  which accompanies this distribution, and is available at
  http://www.eclipse.org/legal/epl-v10.html
-->

<section xml:id="actionSelectWindowWithID" version="5.0" xmlns="http://docbook.org/ns/docbook"
                                                     xmlns:xi="http://www.w3.org/2001/XInclude"
                                                     xmlns:xl="http://www.w3.org/1999/xlink" >
  
  <title>Select Window with Identifier</title>
  
  <para>
    Use this action to switch to a new window that your HTML AUT has opened during the test, or to switch back to the main window once you have performed steps in a second window.
    Without using Webdrivers, in order to allow this, you must have specified the AUT as supporting multi-window mode in the AUT configuration.
  </para>
  
  <para>
    This action allows you to use the window title or other identifiers to select the window.
    The behavior is different depending on whether you use Webdrivers.
    <itemizedlist>
      <listitem>
        <para>
          Without Webdrivers, you can set the identifier type to <emphasis role="strong">title</emphasis>, <emphasis role="strong">name</emphasis>
          or <emphasis role="strong">any</emphasis>.
          If <emphasis role="strong">title</emphasis> or <emphasis role="strong">name</emphasis> is used, the window is selected using these properties.
          However, if you choose <emphasis role="strong">any</emphasis>, then as identifier, you must enter an expression of the form <literal>'var=variable_name'</literal>.
          In this case the current window is searched for a variable with name <literal>variable_name</literal>, and if it contains a popup window's reference, that
          popup window is opened.
        </para>
      </listitem>
      <listitem>
        <para>
          With Webdrivers, the only available options are <emphasis role="strong">title</emphasis> and <emphasis role="strong">name</emphasis>,
          which work the same way as explained above.
        </para>
      </listitem>
    </itemizedlist>
  </para>
  
  <para>
    Parameters:
    
    <itemizedlist>
      <listitem>
        <para>
          <xref linkend="identifier" xrefstyle="template:%t"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="identifier_type" xrefstyle="template:%t"/>
        </para>
      </listitem>
    </itemizedlist>
  </para>
</section>

Back to the top