forked from robotframework/SeleniumLibrary
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathframes.py
More file actions
101 lines (83 loc) · 3.92 KB
/
frames.py
File metadata and controls
101 lines (83 loc) · 3.92 KB
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
# Copyright 2008-2011 Nokia Networks
# Copyright 2011-2016 Ryan Tomac, Ed Manlove and contributors
# Copyright 2016- Robot Framework Foundation
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
from SeleniumLibrary.base import LibraryComponent, keyword
class FrameKeywords(LibraryComponent):
@keyword
def select_frame(self, locator):
"""Sets frame identified by ``locator`` as the current frame.
See the `Locating elements` section for details about the locator
syntax.
Works both with frames and iframes. Use `Unselect Frame` to cancel
the frame selection and return to the main frame.
Example:
| `Select Frame` | top-frame | # Select frame with id or name 'top-frame' |
| `Click Link` | example | # Click link 'example' in the selected frame |
| `Unselect Frame` | | # Back to main frame. |
| `Select Frame` | //iframe[@name='xxx'] | # Select frame using xpath |
"""
self.info("Selecting frame '%s'." % locator)
element = self.find_element(locator)
self.driver.switch_to.frame(element)
@keyword
def unselect_frame(self):
"""Sets the main frame as the current frame.
In practice cancels the previous `Select Frame` call.
"""
self.driver.switch_to.default_content()
@keyword
def current_frame_should_contain(self, text, loglevel='TRACE'):
"""Verifies that current frame contains ``text``.
See `Page Should Contain` for explanation about the ``loglevel``
argument.
Prior to SeleniumLibrary 3.0 this keyword was named
`Current Frame Contains`.
"""
if not self.is_text_present(text):
self.log_source(loglevel)
raise AssertionError("Frame should have contained text '%s' "
"but did not." % text)
self.info("Current frame contains text '%s'." % text)
@keyword
def current_frame_should_not_contain(self, text, loglevel='TRACE'):
"""Verifies that current frame does not contains ``text``.
See `Page Should Contain` for explanation about the ``loglevel``
argument.
"""
if self.is_text_present(text):
self.log_source(loglevel)
raise AssertionError("Frame should not have contained text '%s' "
"but it did." % text)
self.info("Current frame did not contain text '%s'." % text)
@keyword
def frame_should_contain(self, locator, text, loglevel='TRACE'):
"""Verifies that frame identified by ``locator`` contains ``text``.
See the `Locating elements` section for details about the locator
syntax.
See `Page Should Contain` for explanation about the ``loglevel``
argument.
"""
if not self._frame_contains(locator, text):
self.log_source(loglevel)
raise AssertionError("Frame '%s' should have contained text '%s' "
"but did not." % (locator, text))
self.info("Frame '%s' contains text '%s'." % (locator, text))
def _frame_contains(self, locator, text):
element = self.find_element(locator)
self.driver.switch_to.frame(element)
self.info("Searching for text from frame '%s'." % locator)
found = self.is_text_present(text)
self.driver.switch_to.default_content()
return found