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
|
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
from firefox_puppeteer.puppeteer import Puppeteer
from firefox_puppeteer.ui.browser.window import BrowserWindow
class PuppeteerMixin(object):
"""Mix-in class for Firefox specific API modules exposed to test scope.
It also provides common set-up and tear-down code for Firefox tests.
Child test case classes are expected to also subclass MarionetteTestCase such
that PuppeteerMixin is followed by MarionetteTestCase. This will insert the
Puppeteer mixin before the MarionetteTestCase into the MRO.
example:
`class MyTestCase(PuppeteerMixin, MarionetteTestCase)`
The key role of MarionetteTestCase is to set self.marionette appropriately
in `setUp()`. Any TestCase class that satisfies this requirement is
compatible with this class.
If you're extending the inheritance tree further to make specialized
TestCases, favour the use of super() as opposed to explicit calls to a
parent class.
"""
def _check_and_fix_leaked_handles(self):
handle_count = len(self.marionette.window_handles)
url = []
try:
# Verify the existence of leaked tabs and print their URLs.
if self._start_handle_count < handle_count:
message = ('A test must not leak window handles. This test started with '
'%s open top level browsing contexts, but ended with %s.'
' Remaining Tabs URLs:') % (self._start_handle_count, handle_count)
with self.marionette.using_context('content'):
for tab in self.marionette.window_handles:
if tab not in self._init_tab_handles:
url.append(' %s' % self.marionette.get_url())
self.assertListEqual(self._init_tab_handles, self.marionette.window_handles,
message + ','.join(url))
finally:
# For clean-up make sure we work on a proper browser window
if not self.browser or self.browser.closed:
# Find a proper replacement browser window
# TODO: We have to make this less error prone in case no browser is open.
self.browser = self.puppeteer.windows.switch_to(
lambda win: type(win) is BrowserWindow)
# Ensure to close all the remaining chrome windows to give following
# tests a proper start condition and make them not fail.
self.puppeteer.windows.close_all([self.browser])
self.browser.focus()
# Also close all remaining tabs
self.browser.tabbar.close_all_tabs([self.browser.tabbar.tabs[0]])
self.browser.tabbar.tabs[0].switch_to()
def restart(self, **kwargs):
"""Restart Firefox and re-initialize data.
:param flags: Specific restart flags for Firefox
"""
if kwargs.get('clean'):
self.marionette.restart(clean=True)
else:
self.marionette.restart(in_app=True)
# Ensure that we always have a valid browser instance available
self.browser = self.puppeteer.windows.switch_to(lambda win: type(win) is BrowserWindow)
def setUp(self, *args, **kwargs):
super(PuppeteerMixin, self).setUp(*args, **kwargs)
self._start_handle_count = len(self.marionette.window_handles)
self._init_tab_handles = self.marionette.window_handles
self.marionette.set_context('chrome')
self.puppeteer = Puppeteer(self.marionette)
self.browser = self.puppeteer.windows.current
self.browser.focus()
with self.marionette.using_context(self.marionette.CONTEXT_CONTENT):
# Bug 1312674 - Navigating to about:blank twice can cause a hang in
# Marionette. So try to always have a known default page loaded.
self.marionette.navigate('about:')
def tearDown(self, *args, **kwargs):
self.marionette.set_context('chrome')
try:
# This code should be run after all other tearDown code
# so that in case of a failure, further tests will not run
# in a state that is more inconsistent than necessary.
self._check_and_fix_leaked_handles()
finally:
super(PuppeteerMixin, self).tearDown(*args, **kwargs)
|
